DreamAPI
DreamAPIDocs

Video Translate 2.0

POSThttps://api.newportai.com/api/async/video_translate/2.0

Video Translate 2.0 provides comprehensive end-to-end video localization. The engine automatically extracts the original audio, converts it to text via Automated Speech Recognition (ASR), translates the content using Machine Translation (MT), and employs voice cloning (TTS) combined with advanced lip-sync technology. The result is a localized video featuring natural voice quality and perfectly synchronized lip movements. This version is optimized for single-speaker scenarios, making it ideal for multilingual adaptation of courses, lectures, and interviews.

  • Submit a POST request to the Video Translate 2.0 API to obtain a taskId.
  • Submit a POST request to the Polling API to retrieve the translation results.
  • Configure a Callback URL to receive results automatically on completion.

Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

Request Body Parameters

videoUrl string Required

The URL of the video file to be translated. The video duration must not exceed 30 minutes. If the billing duration cannot be determined from this file, the task will fail.

sourceLanguage string Required

Specifies the original language of the video. Supported values: zh (Chinese Mandarin), en (English), ja (Japanese), id (Indonesian), es (Spanish), pt (Portuguese), de (German), fr (French), ko (Korean), fil (Filipino), ms (Malay), th (Thai), ar (Arabic), it (Italian), bn (Bengali), el (Greek), nl (Dutch), ru (Russian), tr (Turkish), vi (Vietnamese), pl (Polish), ro (Romanian), ne (Nepali), uk (Ukrainian), yue (Cantonese).

targetLanguage string Required

Specifies the desired output language. Supported values: zh (Chinese), en (English), ja (Japanese), ko (Korean), de (German), fr (French), it (Italian), ru (Russian), es (Spanish), pt (Portuguese), pl (Polish), nl (Dutch), hi (Hindi), id (Indonesian), th (Thai), vi (Vietnamese), ms (Malay), ar (Arabic), el (Greek).

enableLipSync boolean Required

Determines whether to apply lip-synchronization to the output: true to enable, false to disable.

Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object
taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

Errors

10192Illegal param

Polling

Use the Polling API to retrieve the processing results.

Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

0Task Completed
{
    "code": 0,
    "message": "success",
    "data": {
        "task": {
            "taskId": "235c4d9ce2df437bb9c140341bd93736",
            "status": 3,
            "executionTime": 17232,
            "expire": 1769586737611,
            "taskType": "video_translate/2.0"
        },
        "videos": [
            {
                "videoType": "mp4",
                "videoUrl": "https://dreamface-resource-aigc.oss-us-east-1.aliyuncs.com/dreamapi/o/2026-01-26/f19ec50fc7ca418aafa918f57298ce76.mp4"
            }
        ]
    }
}
Request
cURL
curl -X POST 'https://api.newportai.com/api/async/video_translate/2.0' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{APIKey}}' \
  -d '{
    "videoUrl": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/mq0MSmKgPGQQsxS9UovqH.mp4",
    "sourceLanguage": "zh",
    "targetLanguage": "en",
    "enableLipSync": false
}'
0Successful
{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "235c4d9ce2df437bb9c140341bd93736"
    }
}