视频翻译算子,可高效、精准地将视频内容从源语言转换为一种或多种目标语言,服务范围不仅包含字幕翻译,还涉及语音翻译,最终输出配音后的视频以及相应语言的字幕文件。
算子 ID:las_video_translate
场景 | 描述 |
|---|---|
短剧出海 | 为短剧提供多语言翻译与配音,助力海外发行 |
课程培训 | 培训视频的多语言本地化,支持全球客户学习 |
营销材料 | 广告视频、产品介绍、宣传片的国际化传播 |
输入语言支持如下:
语言代码 | 语言名称 |
|---|---|
zh-CN | 中文(简体) |
en-US | 英语 |
ja-JP | 日语 |
id-ID | 印尼语 |
es-MX | 西班牙语 |
pt-BR | 葡萄牙语 |
de-DE | 德语 |
fr-FR | 法语 |
ko-KR | 韩语 |
fil-PH | 菲律宾语 |
ms-MY | 马来语 |
th-TH | 泰语 |
ar-SA | 阿拉伯语 |
it-IT | 意大利语 |
bn-BD | 孟加拉语 |
el-GR | 希腊语 |
nl-NL | 荷兰语 |
ru-RU | 俄语 |
tr-TR | 土耳其语 |
vi-VN | 越南语 |
pl-PL | 波兰语 |
ro-RO | 罗马尼亚语 |
ne-NP | 尼泊尔语 |
uk-UA | 乌克兰语 |
yue-CN | 粤语 |
输出语言支持如下:
语言代码 | 语言名称 |
|---|---|
zh-CN | 中文(简体) |
en-US | 英语 |
ja-JP | 日语 |
id-ID | 印尼语 |
es-MX | 西班牙语 |
pt-BR | 葡萄牙语 |
de-DE | 德语 |
fr-FR | 法语 |
ko-KR | 韩语 |
fil-PH | 菲律宾语 |
ms-MY | 马来语 |
th-TH | 泰语 |
ar-SA | 阿拉伯语 |
it-IT | 意大利语 |
el-GR | 希腊语 |
nl-NL | 荷兰语 |
ru-RU | 俄语 |
tr-TR | 土耳其语 |
vi-VN | 越南语 |
pl-PL | 波兰语 |
yue-CN | 粤语 |
my-MM | 缅甸语 |
da-DK | 丹麦语 |
fi-FI | 芬兰语 |
he-IL | 希伯来语 |
hi-IN | 印地语 |
km-KH | 高棉语 |
lo-LA | 老挝语 |
no-NO | 挪威语 |
sw-KE | 斯瓦希里语 |
sv-SE | 瑞典语 |
细分项 | 性能影响说明 |
|---|---|
耗时 | 耗时与输入视频时长正相关。 |
细分 | 详细要求 |
|---|---|
支持的输入数据模态 |
|
输入格式:视频 |
|
输入路径要求 | 通过请求参数
|
细分 | 详细要求 |
|---|---|
输出数据模态 |
|
输出格式:视频 |
|
输出格式:文本 |
|
输出格式:音频 |
|
输出路径:TOS | 通过请求参数
|
计费标准
细分项 | 计费标准说明 |
|---|---|
计费项 | 按输入视频的时长统计用量进行计费,每翻译生成一个新语种的视频计费一次。 |
计费类型 | 按量计费,单位: |
单价 | 1.5 元/分钟 |
计费详情
计费公式:总费用 = 单价 * 用量 * 翻译生成的新语种视频数
计费示例
总费用 = 1.5 元/分钟 * 10 分钟 * 3 = 45 元细分项 | 注意与前提 |
|---|---|
开通 LAS |
|
费用 | 调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费。 |
鉴权(API Key) | 调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置。 |
BaseURL | 调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。 |
提交 las_video_translate 算子视频翻译任务。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_video_translate | 本算子的id是 las_video_translate |
operator_version | string | 是 | v1 | 目前只支持v1。 |
data | VideoTranslateReqParams | 是 | 算子参数 | |
video_url | string | 是 | tos://xxx/video.mp4 | 输入视频地址。支持 http/https 和火山 TOS(tos://bucket/key)。支持格式:mp4、mov、avi、mkv、flv、webm。视频时长限制为 10 秒到 4 小时,文件大小不超过 10 GB。不支持包含多种语言音轨的视频输入;若视频不可访问、格式不支持、时长/大小超限,将返回对应错误码。 |
audio_language | string | 是 | zh-CN | 输入视频音轨的源语言代码,必填,需与视频实际主要音频语言一致;当前支持的语言范围见“支持的语言-输入语言”表,如 zh-CN、en-US、ja-JP 等。不支持自动识别,传错可能导致翻译或配音结果异常。 |
output_languages | list of string | 是 | [en-US] | 目标输出语言列表,至少传入 1 个语言代码,需为“支持的语言-输出语言”中的合法值。每个目标语种会分别生成对应字幕文件,并生成对应翻译视频。 |
caption_formats | list of string | 否 | [.srt] | 输出字幕格式列表,可选值为 .txt、.srt、.xml、.vtt,可同时指定多种格式。默认值为 [.srt]。不配置时默认仅生成 srt 字幕;传入空数组、重复值或非法格式时返回 Parameter.Invalid。 |
output_dubbing_audio | boolean | 否 | false | 是否额外输出纯人声配音音频。默认 false。为 true 时,除翻译后视频外,还会额外生成对应目标语言的纯人声音频文件并写入 output_tos_path。 |
output_tos_path | string | 是 | tos://xxx/output | 结果输出目录,对应当前账号可写的火山 TOS 目录,格式为 tos://bucket/prefix。服务会在该目录下写入字幕、翻译视频及其他产物文件,并返回对应 presigned_url。若目录不可写或无权限,将返回上传失败类错误码。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求元信息 | |
task_id | string | task-xxx | 异步模式下的任务 ID,用于作业状态查询。 |
task_status | string | PENDING | 异步模式下的任务状态。
|
business_code | string | 0 | 业务码。 |
error_msg | string | 如有异常,会返回详细的异常信息。 |
请求示例:
# 请将 INPUT_PATH 设置为 保存在本账号下的视频文件TOS路径 export INPUT_PATH="tos://xxxx/sample.mp4" # 请将 OUTPUT_PATH_TEMPLATE 设置为本账号上可写入的tos路径 export OUTPUT_PATH_TEMPLATE="tos://xxxx/output/" # 发起算子服务请求 curl --location "https://operator.las.cn-beijing.volces.com/api/v1/submit" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer $LAS_API_KEY" \ --data '{ "operator_id": "las_video_translate", "operator_version": "v1", "data": { "video_url": "$INPUT_PATH", "audio_language": "zh-CN", "output_languages": ["en-US"], "caption_formats": [".srt"], "output_dubbing_audio": false, "output_tos_path": "$OUTPUT_PATH_TEMPLATE" } }'
返回示例:
{ "metadata": { "task_id": "task-20251125163544-abc123", "task_status": "PENDING", "business_code": "0", "error_msg": "" } }
HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | Parameter.Invalid | The parameter is invalid. | 参数不合法 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权 |
401 | ApiKey.InValid | The api key is invalid. | API不合法 |
查询视频翻译任务的执行状态和结果。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
operator_id | string | 是 | las_video_translate | 算子 ID |
operator_version | string | 是 | v1 | 算子版本 |
task_id | string | 是 | task-xxx | 任务 ID |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metadata | metadata | 请求的元信息。 | |
task_status | string | COMPLETED | 任务状态。
|
business_code | string | ApiKey.InValid | 业务码。 |
error_msg | string | The api key is invalid. | 如有异常,会返回详细的异常信息。 |
task_id | string | test-xxx | 异步模式下的任务 ID。 |
data | VideoTranslateResponse | 返回的数据。 | |
video_url | string | tos://xxx/video.mp4 | 输入视频地址 |
video_duration | float | 72.3 | 输入视频时长 |
translated_captions | list of AssetSummary | 返回字幕 | |
language | string | en-US | 产物语种 |
type | string | translated_caption | 产物类型。translated_caption 表示字幕文件;translated_video 表示配音后视频;translated_audio 表示纯人声配音音频,仅在 output_dubbing_audio=true 时返回 |
format | string | .srt | 字幕文件格式,仅当 type=translated_caption 时返回;可选值为 .txt、.srt、.xml、.vtt。对于 translated_video / translated_audio,该字段为空。 |
tos_path | string | tos://xxx/output/xxx.mp4 | 产物写入 TOS 后的完整路径,例如 tos://bucket/prefix/video_translate_demo_en-US.mp4 |
presigned_url | string | https://... | 预签名链接,存在3天有效期限制;链接过期后请以 tos_path 为准重新生成或直接从目标 TOS 路径访问 |
translated_videos | list of AssetSummary | 翻译产物列表,可能包含 translated_video 与 translated_audio 两类产物 | |
language | string | en-US | 产物语种 |
type | string | translated_video | 产物类型。translated_caption 表示字幕文件;translated_video 表示配音后视频;translated_audio 表示纯人声配音音频,仅在 output_dubbing_audio=true 时返回 |
format | string | 字幕文件格式,仅当 type=translated_caption 时返回;可选值为 .txt、.srt、.xml、.vtt。对于 translated_video / translated_audio,该字段为空。 | |
tos_path | string | tos://xxx/output/xxx.mp4 | 产物写入 TOS 后的完整路径,例如 tos://bucket/prefix/video_translate_demo_en-US.mp4 |
presigned_url | string | https://... | 预签名链接,存在3天有效期限制;链接过期后请以 tos_path 为准重新生成或直接从目标 TOS 路径访问 |
请求示例:
curl --location "https://operator.las.cn-beijing.volces.com/api/v1/poll" \ --header "Content-Type: application/json" \ --header "Authorization: Bearer $LAS_API_KEY" \ --data '{ "operator_id": "las_video_translate", "operator_version": "v1", "task_id": "task-20251125163544-abc123" }'
返回示例:
{ "metadata": { "task_id": "task-20260323153012-abc123", "task_status": "COMPLETED", "business_code": "0", "error_msg": "" }, "data": { "video_url": "tos://path/to/video_translate_demo.mp4", "video_duration": 12.05, "translated_captions": [ { "language": "en-US", "type": "translated_caption", "format": ".srt", "presigned_url": "https://xxx/output/video_translate_demo_en-US_caption.srt" } ], "translated_videos": [ { "language": "en-US", "type": "translated_video", "presigned_url": "https://xxx/output/video_translate_demo_en-US.mp4" } ] } }
HttpStatusCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
400 | Connection.TooMany | Exceed max connections. | 并发过高触发了限流 |
400 | Parameter.Missing | Missing required parameter. | 请求体中缺少必须的参数 |
400 | Parameter.Invalid | Invalid parameter. | 参数不合法 |
400 | Video.DownloadFailed | Video download failed. | 下载异常或访问失败 |
400 | Video.Invalid | Invalid video file. | 视频格式不支持或文件损坏 |
400 | Video.FileTooLarge | Video file is too large. | 视频文件体积超出了系统单次处理上限 |
400 | Video.DurationTooShort | Video duration too short. | 视频时长太短 |
400 | Video.DurationTooLong | Video duration too long. | 视频时长太长 |
400 | Video.AsrFailed | ASR call failed. | 音频分离或 ASR 调用失败 |
400 | Video.FrameExtractionFailed | Frame extraction failed. | 帧提取失败 |
400 | Video.RefineFailed | Refine VLM call failed. | 多模态精修调用或解析失败 |
400 | Video.TranslateFailed | Video translate failed. | 视频翻译失败 |
400 | Video.CaptionUploadFailed | Video caption upload failed. | 字幕上传到 TOS 失败 |
400 | Video.DubbingFailed | Video dubbding failed. | 配音生成失败 |
401 | Authorization.Missing | Missing Authorization. | 缺少鉴权 |
401 | ApiKey.InValid | The api key is invalid. | API不合法 |
400 | Task.NotFound | Task not found. | 任务不存在 |
500 | Internal.ServerError | Internal server error. | 服务内部错误 |