Skip to navigation
API ReferenceTranslate

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.
namestringRequired
Display name, up to 60 characters.
target_languageenumRequired
Language translations using this style will produce.
Allowed values:
instructionsstringRequired

Style-only instructions, up to 4,000 characters. HTML is not accepted; use paired asterisks for emphasis.

Response

This endpoint returns an object.
idstring

Value to pass as translation_style when creating a translation.

namestring
Display name.
target_languageslist of enums
Languages this style can be used with.
Allowed values:
kindenum

Whether this is a built-in or user-created style.

Allowed values:
verifiedboolean
Whether the style instructions passed safety and scope validation.
descriptionstringOptional
Short description of the style.
instructionsstringOptional

The authenticated user’s custom style instructions. Omitted for built-in styles.

created_atdatetimeOptional
Creation time for a custom style.
updated_atdatetimeOptional
Last update time for a custom style.

Errors

400
Invalid Translation Style
401
Authentication Error
429
Rate Limit Error
503
Translation Style Validation Unavailable