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

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是stringabc123-def456-ghi789创建预览任务时返回的task_id

返回参数说明:

task_idstring任务ID
statusint任务状态(1-处理中,2-完成,3-失败)
progressint任务进度(0-100)
result.source_subtitlesarray原始字幕列表
result.translated_subtitlesarray翻译字幕列表
result.translated_audio_urlstring翻译后的音频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