01
POST/v1/audio-separations人声分离
把一个视频分离为人声音轨与背景声音轨。
成功结果人声 WAV + 背景声 WAV
LYNSEY DUBBING / OPEN API
把影视本地化能力，接进你的生产系统。
通过统一的 REST 接口调用人声分离、字幕识别、字幕翻译、AI 配音与自动译制。创建异步业务资源，使用查询或 Webhook 获取最终成果。
- 015 项业务能力
- 02统一异步资源
- 03自动译制返回 MP4
创建自动译制API / V1
POST
/v1/auto-localizations{
"source": {
"type": "url",
"url": "https://media.example.com/episode-01.mp4"
},
"source_language": "zh-CN",
"target_language": "en-US",
"mode": "full",
"voice_mode": "auto",
"subtitle_output": "burned",
"original_audio": "preserve",
"resolution": "original"
}202 · REQUEST ACCEPTED
{ "id": "loc_…", "status": "queued" }任务已受理，通过资源 ID 查询进度或等待 Webhook。
01 / BUSINESS CAPABILITIES
请求哪项能力，就返回哪项结果。
五项能力使用各自的业务资源；自动译制从原视频直接产出目标语言 MP4。02
POST/v1/subtitle-recognitions字幕识别
从视频人声识别字幕，可区分说话人。
成功结果UTF-8 SRT + 结构化字幕行
03
POST/v1/subtitle-translations字幕翻译
翻译已有 SRT 或结构化字幕行。
成功结果目标语言 SRT + 结构化译文
04
POST/v1/dubbingsAI 配音
根据目标语言字幕生成时间轴对齐的配音。
成功结果一条对齐时间轴的 WAV
05
POST/v1/auto-localizations自动译制
在服务端完成识别、翻译、配音与视频合成。
成功结果一个最终 MP4
02 / ASYNCHRONOUS BY DESIGN
一个可重试、可回调的接入闭环。
写请求使用幂等键；处理状态持久化；终态既可查询，也可通过独立验签的 Webhook 接收。- 01
准备素材
传入可直接读取的公网 HTTPS 地址，或使用预签名上传。
- 02
签名并创建
使用 API Key 与 HMAC-SHA256 签名，创建对应业务资源。
- 03
跟踪状态
根据资源 ID 查询 queued、processing 与最终状态。
- 04
接收成果
通过 GET 或终态 Webhook 获取结果，并在有效期内转存。
UPLOAD
本地素材采用三段式直传
申请上传地址 → 直传对象存储 → 提交 ETag 并等待素材校验。只有 ready 状态的 upload_id 才能创建业务资源。
prepare → upload → complete → ready03 / ACCESS & CONTROL
权限由密钥控制，权益由账户决定。
API 密钥在开发者设置中创建。企业版账户所有者创建的工作区可共享套餐权益，密钥不能扩大账户本身的可用权益。能力权限
每组密钥只允许调用创建时勾选的业务能力。
Credit Quota
可为单组密钥设置月度 Credit 上限，用于控制集成方消耗。
IP 白名单
可限制请求来源的公网出口 IP；未配置时不启用来源限制。
密钥安全
API Secret 与 Webhook Secret 仅创建时显示，并分别用于请求和回调验签。
04 / BILLING & RETENTION
按实际业务用量结算。
每个资源返回预留与结算状态。接口文档不写死单价，具体费率与可用额度以 API 开通信息及双方约定为准。| 能力 | 实际用量口径 |
|---|---|
| 人声分离 | 源视频时长，按开始的分钟向上取整 |
| 字幕识别 | 源视频时长，按开始的分钟向上取整 |
| 字幕翻译 | 成功生成的字幕条数 |
| AI 配音 | 目标语言字符数，按开始的 1000 字符向上取整 |
| 自动译制 | 源视频时长，按开始的分钟向上取整 |