Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <api_key>, where <api_key> is your API Key. The token in the sample code is referring to this api_key as well.

Body

application/json
video_url
string
required

Publicly accessible URL of the input video for the server to download. Maximum supported input duration is 20 minutes.

source_language
string
required

Source language code. Auto detection is not supported; pass a supported language code such as en-US or zh-CN.

Pattern: ^[a-z]{2,3}(-[A-Za-z0-9]+)*$
target_language
string
required

Target language code. Locale is optional and may include regional variants, e.g. en, en-US, zh, zh-CN, zh-CN-GUANGXI. Only the language part is validated against the supported list.

Pattern: ^[a-z]{2,3}(-[A-Za-z0-9]+)*$
glossary_ids
string[]

List of glossary IDs from the product. Up to 3 glossaries can be applied during translation for consistent terminology.

Maximum array length: 3
user_prompt
string

Optional prompt to guide visual text translation style.

project_mode
enum<string>

Controls project creation behavior in the web dashboard. editable creates an editable visual translation project; none disables project creation.

Available options:
none,
editable
callback_url
string

Webhook callback URL for status changes.

Response

Job queued

task_id
string
required

ID of the visual translation task.

Last modified on July 9, 2026