API Reference
AI 视频翻译-查询预览任务 API
GET
video-translation-preview-query-api
ID 34
查询视频翻译预览任务状态与预览结果。
GET
https://apis.xiaobao.ink/api/video_translation/query_preview
概述
- task 查询
- 返回预览产物
适用场景
- 轮询预览进度
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key(Query 或 JSON Body,以本接口为准) - 回包 · JSON;请同时校验业务码与 HTTP 状态,不要只看 200
鉴权
请求需携带平台 API Key(查询参数 key 或 JSON 字段 key,以本接口说明为准)。在控制台 API Key 管理 创建密钥。
GET https://apis.xiaobao.ink/api/video_translation/query_preview
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://apis.xiaobao.ink/api/video_translation/query_preview?task_id=你的task_id&key=你的密钥
详细说明
请求参数说明:
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| task_id | 是 | string | abc123-def456-ghi789 | 创建预览任务时返回的task_id |
返回参数说明:
| task_id | string | 任务ID |
| status | int | 任务状态(1-处理中,2-完成,3-失败) |
| progress | int | 任务进度(0-100) |
| result.source_subtitles | array | 原始字幕列表 |
| result.translated_subtitles | array | 翻译字幕列表 |
| result.translated_audio_url | string | 翻译后的音频URL |
返回示例
{"code":200,"msg":"查询成功","data":{"task_id":"abc123-def456-ghi789","status":2,"progress":100,"result":{"source_subtitles":[],"translated_subtitles":[],"translated_audio_url":"https://example.com/audio.mp3"}}}
常见问题
何时调用?
创建预览任务之后,直到成功或失败。
需要什么参数?
Key 与预览 task_id。
成功返回什么?
可能含译文字幕、试听音频等,见文档。
失败怎么办?
根据错误信息检查源视频与语种参数。
任务会过期吗?
以平台任务留存策略为准,尽早拉取结果。
相关接口
完整控制台文档(含调试台):/doc/34