Video Translation API

Updated: 2026-07-14

Overview

• Create video translation tasks and query task results by task ID.
• Supports task creation and result query.
• Tasks are processed asynchronously. After creating a task, the API returns taskId; clients can poll the result endpoint to get the status and output.

Base URL

https://video-translation.viitor.com

Authentication

Authorization: Bearer vt_live_xxx

The server resolves the real user ID from the API Key. The user identity is recognized automatically, and userId is not required.

Common Response Structure

Task Status Enum

Processing Stage Enum

Supported Language Codes

targetLanguage must use a supported language code. If sourceLanguage is provided, it is validated with the same language code set.

1. Create Video Translation Task

Endpoint

• Request URL: https://video-translation.viitor.com/openapi/v1/video-translation/create
• Method: POST
• Content-Type: application/json

HTTP Headers

Request Body

Successful data Fields

Request Example

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
  }'

Successful Response Example

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

2. Query Video Translation Result

• Request URL: https://video-translation.viitor.com/openapi/v1/video-translation/result
• Method: POST
• Headers: same as the create video translation task endpoint

Successful data fields:

Request Example

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"
  }'

Successful Response Example

{
  "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
  }
}

Common Error Codes