Create Translation Style
Create a reusable custom translation style. The instructions are safety-validated
and must only describe translation wording, tone, register, terminology,
transliteration, quote handling, or similar style choices. Instructions cannot
override the target language, change document structure, summarize, add content,
select a model, or alter output-format and safety rules.
Use the returned `id` directly as `translation_style` when creating a translation.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
name
Display name, up to 60 characters.
target_language
Language translations using this style will produce.
Allowed values:
instructions
Style-only instructions, up to 4,000 characters. HTML is not accepted; use paired asterisks for emphasis.
Response
This endpoint returns an object.
id
Value to pass as translation_style when creating a translation.
name
Display name.
target_languages
Languages this style can be used with.
Allowed values:
kind
Whether this is a built-in or user-created style.
Allowed values:
verified
Whether the style instructions passed safety and scope validation.
description
Short description of the style.
instructions
The authenticated user’s custom style instructions. Omitted for built-in styles.
created_at
Creation time for a custom style.
updated_at
Last update time for a custom style.
Errors
400
Invalid Translation Style
401
Authentication Error
429
Rate Limit Error
503
Translation Style Validation Unavailable