跳转到主要内容
POST
/
v1
/
video_translate
创建视频翻译任务
curl --request POST \
  --url https://api.keevx.cn/v1/video_translate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_languages": [
    "English",
    "Chinese"
  ],
  "video_url": "https://example.com/test-video.mp4",
  "speaker_num": 1,
  "translate_audio_only": true,
  "enable_dynamic_duration": true,
  "enable_caption": false,
  "name": "English-videoTranslation-2020120123001",
  "callback_url": "https://your-server.com/callback"
}
'
{
  "code": 0,
  "msg": "ok",
  "data": [
    {
      "task_id": "vt-d6b6472bcf724d0399e06d1390cb964e",
      "language": "English"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.keevx.cn/llms.txt

Use this file to discover all available pages before exploring further.

​
回调通知

视频翻译任务处理完成后，服务将向发起请求中提供的 callback_url 发送一个 POST 请求。

​
结构

​
code
integer
响应状态码。0 表示回调发送成功。
​
msg
string
响应消息，通常为 “ok”。
​
task_type
string
任务类型。枚举值：video_translate。
​
data
object
包含翻译结果的数据载体。

​
回调示例

{
    "code": 0,
    "msg": "ok",
    "task_type": "video_translate",
    "data": {
        "task_id": "vt-d6b6472bcf724d0399e06d1390cb964e",
        "name": "video-translate-1",
        "language": "English",
        "status": "SUCCEEDED",
        "video_url": "https://xiling-dh.bj.bcebos.com/micro-video-translate/task/2026-03-20/vte-hUQf28cbCuufjkdQ/c7298d67-638d-46c9-8914-97b70a825ca1.mp4",
        "caption_url": "https://meta-human-editor-test.cdn.bcebos.com/2026-03-16/e0c18130-fe7c-4fd2-906a-0181fb5994bc.ass",
        "error_message": ""
    }
}

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

创建视频翻译任务。

​
target_languages
string[]
必填

目标语言代码列表

示例:
["English", "Chinese"]
​
video_url
string<uri>
必填

待翻译的视频文件 URL。

示例:

"https://example.com/test-video.mp4"

​
speaker_num
integer
默认值:0

视频中的说话人数量。

必填范围: x >= 0
示例:

1

​
translate_audio_only
boolean
默认值:false

仅翻译音频，忽略面部，只翻译视频中的语音轨道。

示例:

true

​
enable_dynamic_duration
boolean
默认值:true

拉伸或缩短视频片段，以增强不同语速语言之间的对话流畅性和翻译质量。

示例:

true

​
enable_caption
boolean
默认值:false

是否生成字幕。

示例:

false

​
name
string

视频名称，字符长度小于 100。翻译后的视频名称格式为：目标语言 + "-" + name，例如 English_myTestVideo。如果未传值或传空值，翻译后的视频名称格式为：目标语言 + "-" + videoTranslate + "-" + 秒级时间戳，例如：English-videoTranslation-2020120123001。

示例:

"English-videoTranslation-2020120123001"

​
callback_url
string<uri>

任务完成回调通知 URL。

示例:

"https://your-server.com/callback"

响应

任务创建成功

视频翻译任务创建响应

​
code
integer
必填

状态码（0 表示成功）

示例:

0

​
msg
string
必填

响应消息

示例:

"ok"

​
data
object[]
必填

包含生成的任务 ID 和语言的数据