视频翻译接口

更新时间：2026-07-14

服务概述

• 创建视频翻译任务，并通过任务 ID 查询任务结果。
• 支持创建任务和查询任务结果。
• 任务为异步处理模式：创建任务后返回 taskId，客户端轮询结果接口获取状态和输出。

服务地址

https://video-translation.viitor.com

鉴权方式

Authorization: Bearer vt_live_xxx

服务端根据 API Key 解析真实用户 ID，用户身份由 API Key 自动识别，无需传入 userId。

公共响应结构

任务状态枚举

处理阶段枚举

支持的语言编码

targetLanguage 必须使用系统支持的语言编码。sourceLanguage 如果传入，也使用同一套语言编码校验。

1. 创建视频翻译任务

接入方式

• 请求 URL：https://video-translation.viitor.com/openapi/v1/video-translation/create
• 请求方法：POST
• Content-Type：application/json

HTTP 请求头

请求体字段

成功时 data 字段

请求示例

curl -X POST "https://video-translation.viitor.com/openapi/v1/video-translation/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vt_live_xxx" \
  -d '{
    "sourceVideoUrl": "https://cdn.example.com/video/source.mp4",
    "videoName": "Video translation task 001",
    "targetLanguage": "en",
    "sourceVideoDurationMs": 111250
  }'

成功响应示例

{
  "code": 0,
  "message": "OK",
  "data": {
    "taskId": "ViiTor_AI_50C7A13A74DC46D8B31EAEF3382895BA"
  }
}

2. 查询视频翻译结果

• 请求 URL：https://video-translation.viitor.com/openapi/v1/video-translation/result
• 请求方法：POST
• 请求头：同创建视频翻译任务接口

成功时 data 字段：

请求示例

curl -X POST "https://video-translation.viitor.com/openapi/v1/video-translation/result" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer vt_live_xxx" \
  -d '{
    "taskId": "ViiTor_AI_50C7A13A74DC46D8B31EAEF3382895BA"
  }'

成功响应示例

{
  "code": 0,
  "message": "OK",
  "data": {
    "taskId": "ViiTor_AI_50C7A13A74DC46D8B31EAEF3382895BA",
    "videoName": "Video translation task 001",
    "taskStatus": 4,
    "errorCode": 0,
    "sourceLanguage": "zh-CN",
    "targetLanguage": "en",
    "sourceThumbnailUrl": "https://cdn.example.com/video/source-thumbnail.jpg",
    "taskProcessStatus": 9999,
    "targetVideoDuration": 112000,
    "videoDuration": 111250,
    "sourceVideoUrl": "https://cdn.example.com/video/source.mp4",
    "targetVideoUrl": "https://cdn.example.com/video/result.mp4",
    "createTime": 1720000000000
  }
}

常见错误码