API Reference
AI 视频翻译-创建预览任务 API
POST
video-translation-preview-api
ID 33
创建视频翻译预览任务,用于先产出口译/字幕预览再进入合成与导出。
POST
https://apis.xiaobao.ink/api/video_translation/preview
概述
- 创建预览任务
- 异步查询
适用场景
- 翻译效果预览
- 字幕校对前预览
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key(Query 或 JSON Body,以本接口为准) - 回包 · JSON;请同时校验业务码与 HTTP 状态,不要只看 200
鉴权
请求需携带平台 API Key(查询参数 key 或 JSON 字段 key,以本接口说明为准)。在控制台 API Key 管理 创建密钥。
POST https://apis.xiaobao.ink/api/video_translation/preview
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://apis.xiaobao.ink/api/video_translation/preview?key=你的密钥
详细说明
请求HEADER:
| 名称 | 值 |
|---|---|
| Content-Type | application/json |
请求参数说明:
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| url | 是 | string | https://example.com/video.mp4 | 视频URL,必须为可解析的HTTP/HTTPS协议URL |
| language | 是 | string | en-US | 目标翻译语言,如:zh-CN、en-US、en |
| original_srt_url | 否 | string | https://example.com/original.srt | 原始SRT字幕文件URL |
| translate_srt_url | 否 | string | https://example.com/translate.srt | 翻译SRT字幕文件URL |
| speaker_identification | 否 | int | 0 | 区分说话人。0-不区分(默认),1-区分说话人 |
| voice | 否 | string | cv_longanhuan | 音色标识 |
返回示例
{"code":200,"msg":"任务已提交","data":{"id":1,"task_id":"abc123-def456-ghi789","status":1,"video_duration": 90,"power_cost": 40,"progress":0}}
常见问题
预览任务是什么?
在正式导出前生成翻译预览(字幕/音频等),便于确认效果。
必填参数?
视频 URL、目标语种与音色等,见文档。
如何查询预览结果?
使用「查询预览任务」接口与 task_id。
预览后如何出片?
进入合成与导出任务接口继续流程。
能否跳过预览?
视你的产品流程而定;文档允许的路径可直接合成。
相关接口
完整控制台文档(含调试台):/doc/33