API Reference
AI 视频翻译-查询合成任务 API
GET
video-translation-synthesis-query-api
ID 36
查询视频翻译合成任务状态与结果。
GET
https://xiaoapis.com/api/video_translation/query_synthesis
概述
- task 查询
适用场景
- 轮询合成进度
调用约定
- 网关 ·
https://apis.xiaobao.ink - 鉴权 · 请求携带
key(Query 或 JSON Body,以本接口为准) - 回包 · JSON;请同时校验业务码与 HTTP 状态,不要只看 200
鉴权
请求需携带平台 API Key(查询参数 key 或 JSON 字段 key,以本接口说明为准)。在控制台 API Key 管理 创建密钥。
GET https://xiaoapis.com/api/video_translation/query_synthesis
Content-Type: application/json
{
"key": "YOUR_API_KEY"
}
请求示例
https://xiaoapis.com/api/video_translation/query_synthesis?task_id=你的task_id&key=你的密钥
详细说明
请求参数说明:
| 名称 | 必填 | 类型 | 示例值 | 说明 |
|---|---|---|---|---|
| task_id | 是 | string | synthesis-task-456 | 创建合成任务时返回的task_id |
返回参数:
| task_id | string | 任务ID |
| status | int | 任务状态 |
| result.audio_url | string | 合成后的音频URL |
返回示例
{"code":200,"msg":"查询成功","data":{"task_id":"synthesis-task-456","status":2,"progress":100,"result":{"audio_url":"https://example.com/synthesized_audio.mp3"}}}
常见问题
何时调用?
创建合成任务后轮询直至结束。
成功后做什么?
拿到合成产物后调用导出任务生成成片。
参数?
Key + task_id。
状态含义?
见文档枚举。
超时?
拉长轮询间隔并设置业务超时告警。
相关接口
完整控制台文档(含调试台):/doc/36