Skip to main content
POST
cURL

授权

Authorization
string
header
必填

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.

请求体

application/json
video_url
string
必填

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

source_language
string
必填

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
必填

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.

可用选项:
none,
editable
callback_url
string

Webhook callback URL for status changes.

响应

Job queued

task_id
string
必填

ID of the visual translation task.

最后修改于 2026年7月9日