Skip to main content
POST
/
v1
/
translate
/
batch
Batch Translate Text
curl --request POST \
  --url https://api.voxnexus.ai/v1/translate/batch \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "texts": [
    "太冷了",
    "吃晚餐"
  ],
  "target_languages": [
    "en",
    "ja"
  ],
  "model_id": "vn-translate-basic",
  "source_language": "zh"
}
'
[
  {
    "target_language": "en",
    "texts": [
      "It's so cold",
      "Have dinner"
    ],
    "detected_source_language": "zh"
  }
]

Authorizations

​
X-Api-Key
string
header
required

Authenticate using X-Api-Key header

Body

application/json

Batch translation request — translate a group of texts into multiple target languages at once

​
texts
string[]
required

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

Example:
["太冷了", "吃晚餐"]
​
target_languages
string[]
required

Target language codes (ISO 639-1, 1–20 required)

Example:
["en", "ja"]
​
model_id
string
required

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

Example:

"vn-translate-basic"

​
source_language
string

Source language (ISO 639-1). Omit for automatic detection.

Example:

"zh"

Response

Batch translation successful

​
target_language
string
required

Target language code

Example:

"en"

​
texts
string[]
required

Translated texts, in the same order as the request texts

Example:
["It's so cold", "Have dinner"]
​
detected_source_language
string

Detected or echoed source language

Example:

"zh"