Skip to main content
POST
Translate Text

Authorizations

X-Api-Key
string
header
required

Authenticate using X-Api-Key header

Body

application/json

Text translation request

texts
string[]
required

Texts to translate (max 100 items / 50,000 characters)

Example:
target_language
string
required

Target language code (required). Same format as source_language; see GET /v1/models/{model_id}translate_capability.target_languages for the codes a model supports.

Example:

"eng_Latn"

model_id
string
required

Translation model ID (e.g. vn-translate-basic).

Example:

"vn-translate-basic"

source_language
string

Source language code. Omit (or pass auto) for automatic detection; providing this forces the source language. VoxNexus translation language codes use the <ISO 639-3>_<Script> form: an ISO 639-3 language code, _, and an ISO 15924 script code, e.g. eng_Latn, arb_Arab, hin_Deva, zho_Hans, zho_Hant. Other common forms are accepted and normalized, case-insensitively and with - or _: ISO 639-1 (en, ar), ISO 639-3 (eng) and BCP 47 tags (zh-Hans, zh-TW, pt-BR). A region subtag only selects the script and is then dropped (zh-TWzho_Hant, pt-BRpor_Latn).

Example:

"zho_Hans"

Response

Translation successful

text
string
required

Translated text

Example:

"Hello"

detected_source_language
string

When source_language is specified (not blank or auto), it is echoed unchanged (e.g. en, EN_us) and takes precedence over the detected language. Otherwise the detected language is returned as a <ISO 639-3>_<Script> code (e.g. zho_Hans, eng_Latn).

Example:

"zho_Hans"