API Reference

AI 视频切片 - 任务查询 API

GET video-clip-query-api ID 8

查询 AI 视频切片任务状态与结果。

GET https://apis.xiaobao.ink/api/video/clip_taskquery

获取 API Key 工作台 / 调试打开 Markdown

概述

按 task_id 查询
返回进度与结果

适用场景

轮询切片进度

调用约定

网关 · 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/clip_taskquery
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

https://apis.xiaobao.ink/api/video/clip_taskquery?key=你的密钥

详细说明

请求参数说明：

名称	必填	类型	示例值	说明
task_id	是	string	XSSS	任务ID，用于查询任务结果

返回参数说明：

名称	类型	说明
state	int	任务状态码 -11 未识别到有效语音内容 -8 处理超时（语音识别最长处理10分钟；媒体服务最长处理600秒） -7 无效文件（比如文件损坏、格式不对等） -5 超出大小（请参阅每个服务的大小限制） -4 提交失败 -3 下载失败（检查文件URL是否可用） -2 上传失败 -1 失败 0 队列中 1 完成 2 准备中 3 等待中 4 处理中 5 发布中
task_id	string	任务id
created_at	int	创建时间（时间戳）
processed_at	int	处理时间（时间戳）
completed_at	int	完成时间（时间戳）
progress	int	进度，范围0-100
result	array	文件识别出来的内容，数组中的每个元素包含start(片段开始时间，单位：毫秒)、end(片段结束时间，单位：毫秒)和text(识别出的文本内容)字段
- start	int	片段开始时间，单位：毫秒
- end	int	片段结束时间，单位：毫秒
- duration	int	切片时长, 单位: 毫秒
- file_url	string	切片文件对应的URL，可下载对应切片视频
- theme	string	切片主题
- summary	string	切片概要

返回示例

{  "code": 200,  "data": {    "completed_at": 1751822613,    "created_at": 1751822548,    "processed_at": 1751822547,    "progress": 100,    "result": [      {        "duration": 44100,        "end": 33993,        "file_url": "https://xxx",        "start": 1170,        "summary": "这是关于主题1的总结内容",        "theme": "主题1..."      },      {        "duration": 50500,        "end": 40367,        "file_url": "https://xxx",        "start": 10000,        "summary": "这是关于主题2的总结内容",        "theme": "主题2..."      }    ],    "state": 1,    "state_detail": "Complete",    "task_id": "50c80a82-a923-491e-bad6-b7e331035f9c"  }}

错误码

HTTP 响应状态码	说明
200	请求成功
400	客户端参数传递错误，请检查参数是否缺失或值是否正确
401	认证失败。请检查X-API-KEY是否正确或者服务是否开通
404	请求的URL或资源不存在。请检查URL 或 URL中的 task id 是否正确
413	上传的文件超出大小限制。请检查文件大小，参见各个服务的最大文件限制
429	请求频率超出QPS限制。请放缓请求速率，或者联系商务提升QPS限制
500	服务端异常。请反馈给商务或技术对接人员

常见问题

什么时候调用？

创建切片任务后，定期查询直至完成或失败。

需要哪些参数？

API Key 与 task_id（字段名以文档为准）。

状态值含义？

以文档枚举为准，常见为处理中/成功/失败。

可以只靠回调吗？

若创建时配置了回调可等待通知，仍建议保留查询兜底。

查不到任务？

确认 task_id 是否属于本账号且未过期。

AI 视频切片 API

完整控制台文档（含调试台）：/doc/8