You need to enable JavaScript to run this app.
文档中心
AI 数据湖服务

AI 数据湖服务

复制全文
下载 pdf
视频翻译
视频翻译
复制全文
下载 pdf
视频翻译

视频翻译算子,可高效、精准地将视频内容从源语言转换为一种或多种目标语言,服务范围不仅包含字幕翻译,还涉及语音翻译,最终输出配音后的视频以及相应语言的字幕文件。

算子介绍

算子 ID:las_video_translate

适用场景

场景

描述

短剧出海

为短剧提供多语言翻译与配音,助力海外发行

课程培训

培训视频的多语言本地化,支持全球客户学习

营销材料

广告视频、产品介绍、宣传片的国际化传播

核心能力

  • 多语种支持:支持多种语言的翻译,输入语言支持25种语言的视频输入,输出语言支持31种语言的音频配音,涵盖中文、英语、日语、印尼语、西班牙语、葡萄牙语、韩语、法语、德语等多种常见语言。依托大模型强大的翻译能力,可实现极高的翻译准确率与术语本地化能力,满足全球化内容传播的需求。
  • 音色复刻:能够精准提取视频中说话人的声音,实现对说话人声音特质1:1还原。同时,翻译后的语音能够与原始视频的时长精准对齐,确保视频的流畅性和一致性。该能力默认开启、无需额外配置。
  • 便捷的结果交付:支持将翻译后字幕、配音后人声音频与视频直接安全地写入您指定的云端存储(TOS),同时生成预签名下载链接。

效果展示

  • 输入视频
  • 输出视频-英语
  • 输出字幕文件
EP02_en-US_translated_caption_5b3fd2.srt
未知大小
  • 输出视频-日语
  • 输出字幕文件
EP02_ja-JP_translated_caption_a3e42f.srt
未知大小
  • 输出视频-韩语
  • 输出字幕文件
EP02_ko-KR_translated_caption_1d3b1a.srt
未知大小

支持的地域

  • 北京:cn-beijing
  • 上海:cn-shanghai
  • 广州:cn-guangzhou

支持的语言

输入语言支持如下:

语言代码

语言名称

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

瑞典语

算子性能

细分项
性能影响说明

耗时

耗时与输入视频时长正相关。

输入与输出要求

输入要求

细分

详细要求

支持的输入数据模态

  • 视频

输入格式:视频

  • 格式:mp4movavimkvflvwebm
  • 大小:最短 10 秒,最长 4 小时;最大 10 GB。

输入路径要求

通过请求参数 video_url 提供给算子输入数据,当前支持公网 URL、TOS 路径这两种方式。

  • 公网 URL:公网可访问的视频 URL,格式为 http/https
    • 公网 URL 不支持需要登录态或额外 Header 鉴权的地址;临时 URL 需在任务执行期间有效。
  • TOS 路径:将待处理数据上传至与当前 LAS 服务同主账号、同地域的 TOS Bucket后,可提供 TOS 路径,格式为tos://bucket_name/demo
    • TOS 对象需存在且具备读取权限。

输出要求

细分

详细要求

输出数据模态

  • 视频
  • 文本(字幕文件)
  • 音频(可选输出)

输出格式:视频

  • 格式:固定为mp4

输出格式:文本

  • 格式:支持.txt.srt.xml.vtt,通过请求参数caption_formats指定输出的字幕文件格式

输出格式:音频

  • 格式:固定为wav

输出路径:TOS

通过请求参数output_tos_path 指定算子输出结果的存储路径,当前支持设置为 TOS 路径。

  • TOS 路径:与LAS服务同主账号、同地域下,有可写权限的 TOS Bucket 目录,格式:tos://bucket/output/

计费说明
  • 计费标准

    细分项
    计费标准说明

    计费项

    按输入视频的时长统计用量进行计费,每翻译生成一个新语种的视频计费一次。

    计费类型

    按量计费,单位:元/分钟,按实际的计费用量每小时出账。

    单价

    1.5 元/分钟

  • 计费详情
    计费公式:总费用 = 单价 * 用量 * 翻译生成的新语种视频数

  • 计费示例

    • 示例场景:输入了一个 10 分钟的中文视频,需要翻译生成英语、日语、韩语三种语种的新视频。。
    • 费用详情:
      总费用 = 1.5 元/分钟 * 10 分钟 * 3 = 45 元

注意与前提

细分项

注意与前提

开通 LAS

  • 如果您是一个全新的火山引擎用户,此前未开通过 LAS 产品,您可先开通 LAS,不使用 LAS 的计费功能仅开通 LAS 产品不会产生费用。开通操作请参见准备工作
  • 开通完成后可查看算子介绍文档,了解算子能力、上手引导等,详情可参见:LAS 智能数据处理算子

费用

调用算子前,您需先了解使用算子时的模型调用费用,详情请参见大模型调用计费

鉴权(API Key)

调用算子前,您需要先生成算子调用的API Key,并建议将API Key配置为环境变量,便于更安全地调用算子,详情请参见获取 API Key 并配置

BaseURL

调用算子前,您需要先根据您当前使用的LAS服务所在地域,了解算子调用的BaseURL,用于配置算子调用路径参数取值。
详情请参见获取 Base URL,下文中的调用示例仅作为参考,实际调用时需替换为您对应地域的路径取值。

Rest API 调用

Submit

接口说明

提交 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
异步模式下的任务状态。
  • PENDING, 接收请求
  • RUNNING, 正在运行
  • COMPLETED, 已经完成
  • FAILED, 失败
  • TIMEOUT, 超时
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不合法

Poll

接口说明

查询视频翻译任务的执行状态和结果。

请求参数

名称

类型

是否必选

示例值

描述

operator_id

string

las_video_translate

算子 ID

operator_version

string

v1

算子版本

task_id

string

task-xxx

任务 ID

返回数据

参数
类型
示例值
描述
metadata
metadata
请求的元信息。
task_status
string
COMPLETED
任务状态。
  • PENDING, 提交任务排队
  • RUNNING, 正在运行
  • COMPLETED, 已经完成
  • FAILED, 失败
  • TIMEOUT, 超时
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.

服务内部错误

最近更新时间:2026.06.24 14:22:33
这个页面对您有帮助吗?
有用
有用
无用
无用