目标语言与地区
target_language 必填,如 en、ja、es、zh;可选 target_locale(如 en-US)。source_language 默认 auto 自动识别,可用 reference_text 校正源语言识别。
剪狐 · VIDEO TRANSLATION API
为你的应用接入视频翻译与 AI 配音,将原片制作成不同语言的配音视频和字幕文件。适用于内容平台、短剧和商品视频的自动化翻译,支持任务完成通知与按秒计费。
REST · https://unmarkai.cn/api/v1 · API 钱包独立于网页积分与会员
剪狐视频翻译 API 为每种目标语言创建独立异步任务,自动生成字幕与按需配音,支持查询、下载和 Webhook。API 使用独立人民币钱包,不采用网页会员、积分和首次试用规则。
任务配置
以下字段均来自公开 API 契约,完整取值见文档与 OpenAPI。
target_language 必填,如 en、ja、es、zh;可选 target_locale(如 en-US)。source_language 默认 auto 自动识别,可用 reference_text 校正源语言识别。
subtitle_enabled 默认开启;subtitle_mode 可选 translated 或 bilingual,并可设置 subtitle_style 与 subtitle_layout。同时返回源语言与译文字幕资源。
tts_enabled 默认开启;voice_strategy 默认 clone,选择 sim 使用更低的基础费率,也可从 GET /voices 选择预设 voice_key。关闭配音时保留原音轨,仍生成翻译字幕。
配音时 preserve_background_audio 默认保留背景音;output_resolution 可选 source、720p、1080p,保留比例,不强行放大小分辨率素材。
| 需要的结果 | tts_enabled | subtitle_enabled |
|---|---|---|
| 配音 + 译文字幕的成片 | true | true |
| 保留原声,只加翻译字幕 | false | true |
| 配音成片,不烧录字幕 | true | false |
| 只要字幕文件 | false | false(result.video 为 null) |
新翻译任务不自动擦除原视频字幕;需要先清理画面文字时,可先调用视频去字幕 / 去水印 API。任务自动处理,配音与字幕时间轴自动对齐。
接入流程
调用 POST /uploads 获取直传凭证后 PUT 视频字节;或调用 POST /url-uploads 从公网 HTTPS 视频直链异步导入,等待 status=uploaded。
调用 POST /jobs,传入 type=video_translation、upload_id 与 target_language,并携带 Idempotency-Key。需要多种语言时,按语言分别创建任务。
轮询 GET /jobs/{job_id},或在控制台配置 HTTPS 接收地址接收任务事件;翻译运行中也可申请取消,以服务端返回为准。
结果位于 result.video、source_subtitles、translated_subtitles 等资源中,先判断资源是否为 null 再下载。链接最长有效 1 小时,终态后保留 7 天。
计费方式
当前标准价;实际价格以 GET /balance 与任务金额为准。
普通翻译
¥0.060 / 秒折合 ¥3.60 / 分钟
高级翻译 advanced_quality
折合 ¥7.20 / 分钟
最低计费
15 秒 / 任务每视频按秒向上取整
省略 voice_strategy 默认克隆。选择 sim 可降低配音费用,两种模式都适用账户折扣。
| 音色方案 | 普通翻译 | 高级翻译 |
|---|---|---|
克隆原声(默认)voice_strategy: clone | ¥3.60 / 分钟 ¥0.060 / 秒 | ¥7.20 / 分钟 ¥0.120 / 秒 |
相似音色voice_strategy: sim | ¥2.40 / 分钟 ¥0.040 / 秒 | ¥4.80 / 分钟 ¥0.080 / 秒 |
使用 GET /voices 的预设音色,或设置 tts_enabled=false,均与 sim 同价。字幕样式和背景音不另加价。
选择相似音色时,在创建请求中加入 "voice_strategy": "sim";例如普通翻译 61 秒,克隆为 ¥3.66,sim 为 ¥2.44。
一个明确条件下的例子
按 61 秒计,标准价为 ¥3.66。以上价格包含默认克隆。相似音色、预设音色或关闭配音为普通 ¥0.040/秒、高级 ¥0.080/秒;字幕样式和背景音不额外加价。每种目标语言单独计费。
快速开始
上传完成后提交任务。密钥只放在服务端环境变量中;每个新业务请求生成一次幂等键,重试时复用。
curl 'https://unmarkai.cn/api/v1/jobs' \
-H "Authorization: Bearer $UNMARKAI_API_KEY" \
-H 'Idempotency-Key: replace-with-a-unique-business-request-id' \
-H 'Content-Type: application/json' \
-d '{
"type": "video_translation",
"input": {"upload_id": "upl_REPLACE"},
"target_language": "en",
"source_language": "auto",
"tts_enabled": true,
"subtitle_enabled": true,
"subtitle_mode": "translated"
}'
常见问题
更多细节见 API 文档。
不可以。每个 video_translation 任务对应一种目标语言;需要多种语言时,按语言分别创建任务,每个任务单独计费。
从人民币 API 钱包按秒扣费:普通翻译标准价 ¥0.060/秒,高级翻译 ¥0.120/秒,每视频按秒向上取整,最低 15 秒。以上为默认克隆价格;相似音色、预设音色或关闭配音为 ¥0.040/秒、¥0.080/秒。实际价格以 GET /balance 和任务金额为准。
API 使用独立钱包,翻译任务按完整时长自动执行。实付充值到账或获发 API 额度后,成片免剪狐水印。
可以。tts_enabled=false 保留原音轨并生成翻译字幕;tts_enabled 与 subtitle_enabled 同为 false 时仅交付字幕资源,result.video 为 null。仅字幕也按所选普通或高级价格计费。
通过 voice_strategy 选择 clone 或 sim,或调用 GET /voices 获取预设音色目录后传入有效的 voice_key。请使用返回的音色目录,不要自行拼造音色标识。
不会。新翻译任务不自动擦除原视频字幕。如需清理原有硬字幕,可先调用视频去字幕 / 去水印 API,再用处理后的视频创建翻译任务。
暂不可以。MCP 当前覆盖擦除工作流,视频翻译通过 REST 接口 https://unmarkai.cn/api/v1 提供。
YOUR PIPELINE. ANOTHER LANGUAGE.