跳到正文
平台 / 文档 / AI 视频翻译-查询合成任务 API

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是stringsynthesis-task-456创建合成任务时返回的task_id

返回参数:

task_idstring任务ID
statusint任务状态
result.audio_urlstring合成后的音频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