剪狐 · VIDEO TRANSLATION API

视频翻译 / AI 配音 API

为你的应用接入视频翻译与 AI 配音,将原片制作成不同语言的配音视频和字幕文件。适用于内容平台、短剧和商品视频的自动化翻译,支持任务完成通知与按秒计费。

REST · https://unmarkai.cn/api/v1 · API 钱包独立于网页积分与会员

翻译 API 与网页翻译有什么区别?

剪狐视频翻译 API 为每种目标语言创建独立异步任务,自动生成字幕与按需配音,支持查询、下载和 Webhook。API 使用独立人民币钱包,不采用网页会员、积分和首次试用规则。

默认克隆标准价
普通 ¥0.060/秒,高级 ¥0.120/秒,最低 15 秒。
其他声音选项
相似音色、预设音色或关闭配音为普通 ¥0.040/秒、高级 ¥0.080/秒。
交付条件
每种目标语言单独计费;API 自动执行,不包含网页生成前审改流程。

任务配置

一个任务,可以配置什么?

以下字段均来自公开 API 契约,完整取值见文档与 OpenAPI。

01 / 语言

目标语言与地区

target_language 必填,如 en、ja、es、zh;可选 target_locale(如 en-US)。source_language 默认 auto 自动识别,可用 reference_text 校正源语言识别。

02 / 字幕

烧录译文或双语字幕

subtitle_enabled 默认开启;subtitle_mode 可选 translated 或 bilingual,并可设置 subtitle_style 与 subtitle_layout。同时返回源语言与译文字幕资源。

03 / 配音

AI 配音与音色

tts_enabled 默认开启;voice_strategy 默认 clone,选择 sim 使用更低的基础费率,也可从 GET /voices 选择预设 voice_key。关闭配音时保留原音轨,仍生成翻译字幕。

04 / 背景音与输出

保留背景音,选择分辨率

配音时 preserve_background_audio 默认保留背景音;output_resolution 可选 source、720p、1080p,保留比例,不强行放大小分辨率素材。

常见输出组合
需要的结果 tts_enabled subtitle_enabled
配音 + 译文字幕的成片 true true
保留原声,只加翻译字幕 false true
配音成片,不烧录字幕 true false
只要字幕文件 false false(result.video 为 null)

新翻译任务不自动擦除原视频字幕;需要先清理画面文字时,可先调用视频去字幕 / 去水印 API。任务自动处理,配音与字幕时间轴自动对齐。

接入流程

接入流程:四步完成一次翻译

完整快速入门
  1. 01

    上传或导入原片

    调用 POST /uploads 获取直传凭证后 PUT 视频字节;或调用 POST /url-uploads 从公网 HTTPS 视频直链异步导入,等待 status=uploaded。

  2. 02

    为每种目标语言创建任务

    调用 POST /jobs,传入 type=video_translation、upload_id 与 target_language,并携带 Idempotency-Key。需要多种语言时,按语言分别创建任务。

  3. 03

    查询进度或接收 Webhook

    轮询 GET /jobs/{job_id},或在控制台配置 HTTPS 接收地址接收任务事件;翻译运行中也可申请取消,以服务端返回为准。

  4. 04

    下载视频与字幕

    结果位于 result.video、source_subtitles、translated_subtitles 等资源中,先判断资源是否为 null 再下载。链接最长有效 1 小时,终态后保留 7 天。

计费方式

人民币 API 钱包,按秒计费

当前标准价;实际价格以 GET /balance 与任务金额为准。

普通翻译

¥0.060 / 秒

折合 ¥3.60 / 分钟

高级翻译 advanced_quality

¥0.120 / 秒

折合 ¥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 秒视频,普通翻译成一种语言

按 61 秒计,标准价为 ¥3.66。以上价格包含默认克隆。相似音色、预设音色或关闭配音为普通 ¥0.040/秒、高级 ¥0.080/秒;字幕样式和背景音不额外加价。每种目标语言单独计费。

¥3.66标准价 · 该示例条件下
微信单次充值 ¥200–10,000,1 元实付到账 1 元;API 钱包独立于网页积分、会员和试用。
近 365 天累计净充值达到档位可享折扣。
查看计费与折扣档位 ↗

快速开始

一个请求,创建翻译任务

翻译与配音完整参数

上传完成后提交任务。密钥只放在服务端环境变量中;每个新业务请求生成一次幂等键,重试时复用。

bashPOST /jobs
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"
  }'

返回 202 与任务资源。完整字段、音色目录和示例见API 文档;完整契约见 OpenAPI。

常见问题

视频翻译 API 常见问题

更多细节见 API 文档。

一个任务可以翻译成多种语言吗?

不可以。每个 video_translation 任务对应一种目标语言;需要多种语言时,按语言分别创建任务,每个任务单独计费。

API 翻译怎么收费?

从人民币 API 钱包按秒扣费:普通翻译标准价 ¥0.060/秒,高级翻译 ¥0.120/秒,每视频按秒向上取整,最低 15 秒。以上为默认克隆价格;相似音色、预设音色或关闭配音为 ¥0.040/秒、¥0.080/秒。实际价格以 GET /balance 和任务金额为准。

API 和网页工作台共用积分或会员吗?

API 使用独立钱包,翻译任务按完整时长自动执行。实付充值到账或获发 API 额度后,成片免剪狐水印。

可以只要字幕,不要配音吗?

可以。tts_enabled=false 保留原音轨并生成翻译字幕;tts_enabled 与 subtitle_enabled 同为 false 时仅交付字幕资源,result.video 为 null。仅字幕也按所选普通或高级价格计费。

怎么选择配音音色?

通过 voice_strategy 选择 clone 或 sim,或调用 GET /voices 获取预设音色目录后传入有效的 voice_key。请使用返回的音色目录,不要自行拼造音色标识。

翻译会自动去掉原视频里的字幕吗?

不会。新翻译任务不自动擦除原视频字幕。如需清理原有硬字幕,可先调用视频去字幕 / 去水印 API,再用处理后的视频创建翻译任务。

可以通过 MCP 调用翻译吗?

暂不可以。MCP 当前覆盖擦除工作流,视频翻译通过 REST 接口 https://unmarkai.cn/api/v1 提供。

YOUR PIPELINE. ANOTHER LANGUAGE.

从第一个请求,
接入视频翻译

内容维护:剪狐 · 更新于