视频翻译 V3 API 接口文档

POST/image/v3/make/videoTranslationapplication/json

请求体

sourceVideoUrlstring必填

待翻译原视频的公网 URL；服务端会读取真实媒体时长用于计费

targetLanguagestring必填

目标语言，支持短代码或 BCP-47 代码，详见下方支持的语言

sourceVideoNamestring可选

原视频文件名，仅用于历史记录展示

lipSyncboolean可选默认true

是否同步口型；false 仅关闭口型同步，不关闭翻译语音。

videoTypestring可选

视频翻译模型；不传时使用默认模型，支持值见下方扣费标准

useAssetWhitelistboolean可选默认true

是否使用素材库加白；省略或 null 同默认。true 使用素材库资产，false 直接提交素材 URL；预检规则及人脸审核风险见下方Seedance 素材加白。

Seedance 素材加白

useAssetWhitelist 用于选择参考素材进入素材库加白，还是直接以 URL 提交模型，放在本页请求体中，与 videoType 同级。支持情况以所选模型为准。

取值	具体用途与提交方式	预检规则
`true`（默认）	需要入库的参考图片/视频先上传素材库，再用资产 ID 提交，适合需要素材库人像加白的场景。	入库参考图片按素材库限制整组预检后再上传；视频保留已有时长、数量、格式、大小等业务约束，不套用图片像素规则。
`false`	关闭自动入库和历史资产 ID 复用，直接使用素材 URL，适合希望按当前模型规格直传的场景。	按当前模型配置的尺寸、比例、大小、格式、时长等限制预检。

素材库参考图片要求：宽和高均为 300～6000 像素（含边界），宽高比 2:5～5:2（含边界），单张小于 30 MiB（供应商文档标为 30 MB）；支持 JPEG（含 JPG）、PNG、WEBP、TIFF（含 TIF）、GIF、HEIC/HEIF。该规格仅用于图片入库，素材数量、时长及组合等业务约束仍按模型校验。依据：私域虚拟人像素材资产库使用指南。

原视频是否入库还受服务端视频资产配置控制：即使传 true，服务端关闭视频资产功能且无已有资产时仍使用 URL，并按模型规则预检；已有合法资产沿现有逻辑复用。传 false 时不上传，也不复用历史资产 ID。

人脸审核风险：关闭加白时，包含人脸或真人肖像的素材可能被供应商审核拒绝；开启加白仍须通过素材库和模型审核，不能保证成功。尺寸等预检通过不代表内容审核通过。

如需关闭加白，在本页完整请求中加入 "useAssetWhitelist": false；省略或传 null 均按 true 处理。

支持的语言

targetLanguage 必须使用下表中的语言。源语言由服务端自动识别，不提供源语言请求参数。

语言	短代码	BCP-47 代码
中文	`zh`	`zh-CN`
英语	`en`	`en-US`
日语	`ja`	`ja-JP`
韩语	`ko`	`ko-KR`
西班牙语	`es`	`es-ES`
法语	`fr`	`fr-FR`
德语	`de`	`de-DE`
葡萄牙语	`pt`	`pt-BR`
阿拉伯语	`ar`	`ar-SA`
泰语	`th`	`th-TH`
越南语	`vi`	`vi-VN`
印尼语	`id`	`id-ID`
马来语	`ms`	`ms-MY`

目标语言代码匹配不区分大小写，并兼容下划线形式（例如 en_US）。

模型与生成规则

将视频语音翻译为目标语言；lipSync=false 仅关闭口型同步，不是静音。本接口不提供独立声音开关或参考音频输入，请勿传入 voice 或 audio。

自动识别原视频语言，按 targetLanguage 翻译；lipSync 控制是否同步口型。不传 videoType 时使用默认模型；可灵模型也跟随原视频时长。

Seedance 2.5 比例限制

Seedance 2.5 的视频编辑/延长任务仅支持自适应，输出比例跟随原视频，不支持自定义比例。本接口不接收 aspectRatio，无需传入。

时长规则

所有模型均跟随原视频时长，不支持自定义时长，无需传 videoTime 或 duration。请使用可持续访问的视频 URL；计费时长按原视频实际时长向下取整为整数秒，具体扣费见页面末尾。

请求示例

自动识别原视频语音，翻译为英语并同步口型

JSON

{
  "sourceVideoUrl": "https://example.com/source.mp4",
  "targetLanguage": "en"
}

指定模型，关闭口型同步

JSON

{
  "sourceVideoUrl": "https://example.com/source-ko.mp4",
  "targetLanguage": "zh-CN",
  "lipSync": false,
  "videoType": "doubao-seedance-2-5"
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

常见问题

目标语言无效：确认使用支持语言表中的短代码或 BCP-47 代码。
模型不可用：不传 videoType 使用默认模型，或确认传入值是扣费标准中展示的公开模型名称。
无法读取原视频时长：确认 URL 可公网访问、未过期，并且返回可解析的视频内容。
任务失败或长时间无结果：确认视频地址在异步任务执行期间持续可访问，并检查内容合规、账户算力和上游模型状态。

扣费标准

正在读取当前模型扣点...

扣点数 = 单价（点/秒）× 计费时长（秒）。计费时长按原视频实际时长向下取整为整数秒；如果当前模型设置了计费时长上限，则以该上限为准。

创建上限

配置项	上限
创建中 / 生成中任务上限	100 个