MaaS_HG_video_translate API文档
请求协议
Http
请求Header
| 参数名 | 值 |
|---|---|
| x-api-key | your-api-key |
| content-type | application/json |
| accept | application/json |
视频翻译接口
请求方法
POST
请求URL
https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| video_url | string | 是 | 视频文件的 URL。支持直接视频文件链接、Google Drive 链接和 YouTube 链接。 |
| title | string | 否 | 视频标题。 |
| output_language | string | 是（单语言时） | 目标翻译语言（单个）。必须提供 output_language 或 output_languages 之一。 |
| translate_audio_only | boolean | 否 | 默认为 false。仅翻译音频，忽略画面，适用于无出镜的旁白、配音等场景。 |
| speaker_num | int32 | 否 | 视频中的说话人数。 |
| callback_id | string | 否 | 自定义 ID，用于回调追踪。将在状态/ webhook 响应中返回。 |
| enable_dynamic_duration | string | 否 | 调整视频片段长度以提升跨语言对话流畅度和翻译质量（如不同语速的语言）。 |
| keep_the_same_format | boolean | 否 | 默认为 false。设为 true 可确保输入与输出画质一致。 |
| mode | string | 否 | • fast：快速生成，适合标准翻译 • quality：高质量唇形同步，但消耗双倍积分 |
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| error | string | 请求失败时显示错误信息；请求成功时显示 null |
| data | object | 包含已翻译的视频id |
| data.video_translate_id | string | 已翻译视频的唯一标识符。 |
请求示例
Request
curl --request POST \
--url https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'Authorization: Bearer XX' \
--data '
{
"translate_audio_only": "false",
"keep_the_same_format": "false",
"mode": "fast",
"video_url": "https://storage.googleapis.com/wangshi-usw/wangshi-use/343170513536603082/sample_0.mp4",
"output_language": "Chinese (Mandarin, Simplified)",
"title": "test"
}
'
Response
{
"error": null,
"data": {
"video_translate_id": "8t4ca15b649d4bc1936f5ca2edd0c1c6-ur_ur-PK",
"video_translate_ids": null
}
}
查询视频翻译状态接口
请求方法
GET
请求URL
https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate/{video_translate_id}
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| video_translate_id | string | 是 | 路径参数，已翻译视频的唯一标识符 |
响应参数
| 字段 | 类型 | 说明 |
|---|---|---|
| error | string | 当请求失败时显示错误信息；请求成功时为 null。 |
| data | object | 包含翻译视频的详细信息。 |
| video_translate_id | string | 翻译视频的唯一标识符。 |
| title | string | 视频标题。 |
| output_language | string | 视频被翻译成的目标语言。 |
| status | string | 视频当前状态。• failed: 视频渲染失败• pending: 等待排队• success: 视频渲染成功• running: 正在渲染中 |
| url | string | 翻译后视频的 URL。该链接 7 天后过期，过期后需重新调用接口获取新链接。 |
| message | string | 新增字段，包含人类可读的状态说明。发生错误时返回解释信息。 |
| caption_url | string | 字幕文件的 URL（.ass 格式），仅当请求时设置了 'caption: true' 才返回。 |
请求示例
Request
curl --request GET \
--url https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate/7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK\
--header 'accept: application/json' \
--header 'Authorization: Bearer XX'
Response
// If the video rendering is completed, the response looks like this:
{
"error": null,
"data": {
"video_translate_id": "7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK",
"title": "My Translated Video",
"output_language": "Urdu (Pakistan)",
"status": "success",
"url": "https://resource2.heygen.ai/video_translate/7544c0b52ada44fda693a15b1181b5b4-ur_ur-PK/original.mp4?response-content-disposition=attachment%3B+filename%2A%3DUTF-8%27%27My%2520Translated%2520Video.mp4%3B",
"message": null,
"callback_id": null,
"caption_url": null
}
}
支持语言查询接口
请求方法
GET
请求URL
https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate/target_languages
请求示例
Request
curl --request GET \
--url https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate/target_languages \
--header 'accept: application/json' \
--header 'Authorization: Bearer XX'
Response
{
"error": null,
"data": {
"languages": [
"English",
"Spanish",
"French",
"Hindi",
"Italian",
"German",
"Polish",
"Portuguese",
"Chinese",
"Japanese",
"Dutch",
"Turkish",
"Korean",
"Danish",
"Arabic",
"Romanian",
"Mandarin",
"Filipino",
"Swedish",
"Indonesian",
"Ukrainian",
"Greek",
"Czech",
"Bulgarian",
"Malay",
"Slovak",
"Croatian",
"Tamil",
"Finnish",
"Russian",
"Afrikaans (South Africa)",
"Albanian (Albania)",
"Amharic (Ethiopia)",
"Arabic (Algeria)",
"Arabic (Bahrain)",
"Arabic (Egypt)",
"Arabic (Iraq)",
"Arabic (Jordan)",
"Arabic (Kuwait)",
"Arabic (Lebanon)",
"Arabic (Libya)",
"Arabic (Morocco)",
"Arabic (Oman)",
"Arabic (Qatar)",
"Arabic (Saudi Arabia)",
"Arabic (Syria)",
"Arabic (Tunisia)",
"Arabic (United Arab Emirates)",
"Arabic (Yemen)",
"Armenian (Armenia)",
"Azerbaijani (Latin, Azerbaijan)",
"Bangla (Bangladesh)",
"Basque",
"Bengali (India)",
"Bosnian (Bosnia and Herzegovina)",
"Bulgarian (Bulgaria)",
"Burmese (Myanmar)",
"Catalan",
"Chinese (Cantonese, Traditional)",
"Chinese (Jilu Mandarin, Simplified)",
"Chinese (Mandarin, Simplified)",
"Chinese (Northeastern Mandarin, Simplified)",
"Chinese (Southwestern Mandarin, Simplified)",
"Chinese (Taiwanese Mandarin, Traditional)",
"Chinese (Wu, Simplified)",
"Chinese (Zhongyuan Mandarin Henan, Simplified)",
"Chinese (Zhongyuan Mandarin Shaanxi, Simplified)",
"Croatian (Croatia)",
"Czech (Czechia)",
"Danish (Denmark)",
"Dutch (Belgium)",
"Dutch (Netherlands)",
"English (Australia)",
"English (Canada)",
"English (Hong Kong SAR)",
"English (India)",
"English (Ireland)",
"English (Kenya)",
"English (New Zealand)",
"English (Nigeria)",
"English (Philippines)",
"English (Singapore)",
"English (South Africa)",
"English (Tanzania)",
"English (UK)",
"English (United States)",
"Estonian (Estonia)",
"Filipino (Philippines)",
"Finnish (Finland)",
"French (Belgium)",
"French (Canada)",
"French (France)",
"French (Switzerland)",
"Galician",
"Georgian (Georgia)",
"German (Austria)",
"German (Germany)",
"German (Switzerland)",
"Greek (Greece)",
"Gujarati (India)",
"Hebrew (Israel)",
"Hindi (India)",
"Hungarian (Hungary)",
"Icelandic (Iceland)",
"Indonesian (Indonesia)",
"Irish (Ireland)",
"Italian (Italy)",
"Japanese (Japan)",
"Javanese (Latin, Indonesia)",
"Kannada (India)",
"Kazakh (Kazakhstan)",
"Khmer (Cambodia)",
"Korean (Korea)",
"Lao (Laos)",
"Latvian (Latvia)",
"Lithuanian (Lithuania)",
"Macedonian (North Macedonia)",
"Malay (Malaysia)",
"Malayalam (India)",
"Maltese (Malta)",
"Marathi (India)",
"Mongolian (Mongolia)",
"Nepali (Nepal)",
"Norwegian Bokmål (Norway)",
"Pashto (Afghanistan)",
"Persian (Iran)",
"Polish (Poland)",
"Portuguese (Brazil)",
"Portuguese (Portugal)",
"Romanian (Romania)",
"Russian (Russia)",
"Serbian (Latin, Serbia)",
"Sinhala (Sri Lanka)",
"Slovak (Slovakia)",
"Slovenian (Slovenia)",
"Somali (Somalia)",
"Spanish (Argentina)",
"Spanish (Bolivia)",
"Spanish (Chile)",
"Spanish (Colombia)",
"Spanish (Costa Rica)",
"Spanish (Cuba)",
"Spanish (Dominican Republic)",
"Spanish (Ecuador)",
"Spanish (El Salvador)",
"Spanish (Equatorial Guinea)",
"Spanish (Guatemala)",
"Spanish (Honduras)",
"Spanish (Mexico)",
"Spanish (Nicaragua)",
"Spanish (Panama)",
"Spanish (Paraguay)",
"Spanish (Peru)",
"Spanish (Puerto Rico)",
"Spanish (Spain)",
"Spanish (United States)",
"Spanish (Uruguay)",
"Spanish (Venezuela)",
"Sundanese (Indonesia)",
"Swahili (Kenya)",
"Swahili (Tanzania)",
"Swedish (Sweden)",
"Tamil (India)",
"Tamil (Malaysia)",
"Tamil (Singapore)",
"Tamil (Sri Lanka)",
"Telugu (India)",
"Thai (Thailand)",
"Turkish (Türkiye)",
"Ukrainian (Ukraine)",
"Urdu (India)",
"Urdu (Pakistan)",
"Uzbek (Latin, Uzbekistan)",
"Vietnamese (Vietnam)",
"Welsh (United Kingdom)",
"Zulu (South Africa)",
"English - Your Accent",
"English - American Accent"
]
}
}
获取已视频翻译字幕文件接口
请求方法
GET
请求URL
https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate/caption?video_translate_id={video_translate_id}\&caption_type=vtt
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| video_translate_id | string | 是 | 查询参数，已翻译视频的唯一标识符 |
| caption_type | string | 是 | 字幕文件格式，允许值：vtt |
请求示例
Request
curl --request GET \
--url 'https://genaiapi.cloudsway.net/v1/ai/${ENDPOINT_PATH}/heygen/video_translate/caption?video_translate_id=6vr40c621282471bb03cd9n61acf7faa-ur_ur-PK/6vr40c621282471bb03cd9n61acf7faa-ur_ur-PK&caption_type=vtt' \
--header 'accept: application/json' \
--header 'Authorization: Bearer XX'
Response
{
"error": null,
"data": {
"caption_url": "https://files2.heygen.ai/video_translate/6vr40c621282471bb03cd9n61acf7faa-ur_ur-PK/6vr40c621282471bb03cd9n61acf7faa-ur_ur-PK.vtt?Expires=1760528877&Signature=qkWYJB7HDZkOfaQNWBdvIYc34MAJ1~SPnDdPgXg0VefkJQnttfMXup2Qzvewq8SmbdTYr9POyrYKUAXs1gCqql1-v2q-G-dd6~Xp5QMo6L6sYCwrsbkSrofZYe2fsggsg9j-RYmlZ22qNiavJgYEWy1Do3R9TH-bctSXJPlgyYYZDhYeDLLK5HklOi0f2d7WUiN2wWpQhRyLOsXSpB-961rY-jQad0Digq~-WqsMgjkUpAsQxadXVo-0xtpYssyIVsZue59hf-XMO4IN1dHq~Dt1MgxKpmXFBjiFk6eSPyXCyp3EbuZZ9rEc5CwIA25IvWGvdAR-Tfp3iPMast2dJw__&Key-Pair-Id=K52HBHX5LX3X2H"
}
}