API Reference

AI 视频切片 API

Q: 和多视频合成的关系？

切片产出可再进入合成或发布流程。

POST video-clip-api ID 7

对视频进行切片处理，便于拆条、二次剪辑与内容分发。

POST https://apis.xiaobao.ink/api/video/clip

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

概述

视频切片
异步任务
任务查询

适用场景

长视频拆条
切片分发
二次剪辑

调用约定

网关 · https://apis.xiaobao.ink
鉴权 · 请求携带 key（Query 或 JSON Body，以本接口为准）
回包 · JSON；请同时校验业务码与 HTTP 状态，不要只看 200

鉴权

请求需携带平台 API Key（查询参数 key 或 JSON 字段 key，以本接口说明为准）。在控制台 API Key 管理创建密钥。

POST https://apis.xiaobao.ink/api/video/clip
Content-Type: application/json

{
  "key": "YOUR_API_KEY"
}

请求示例

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

详细说明

请求HEADER：

名称	值
Content-Type	application/json

请求参数说明：

名称	必填	类型	示例值	说明
url	是	string	https://xxx.mp4	预处理视频的URL，必须为可解析的HTTP协议URL；如果URL的path没有文件扩展名，需要额外指定extension参数，比如extension=mp3；最长512个字符串；下载超时5分钟（如果5分钟未下载完成则失败）；视频文件必须带音频信息，文件时长5h，大小4G
scene_id	是	string	0	场景Id 切片场景，指定视频类型。 0-通用场景(默认) 1-直播内容 2-体育赛事 3-访谈演讲 4-影视综艺
slice_method	是	int	0	切片方式，返回的切片效果。 0-连续片段：完整截取视频中的连续段落(默认) 1-智能拼接：自动合并多个片段拼接成完整主题切片
slice_length	是	int	30～60	切片长度，指定生成的每个切片的大致长度(默认:30~180） 30～60 60~90 90~120 120~180 180~300 300

返回示例

{  "code": 200,  "msg": "任务创建成功",  "data": {    "id": 1,    "task_id": "93e356ce-4b27-428c-ae6c-fe6815f23570"  },  "exec_time": 0.418544,  "ip": "112.49.185.124"}

错误码

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

常见问题

视频切片 API 做什么？

按规则将视频切成片段，返回切片结果供分发或再编辑。

如何创建与查询？

调用切片创建接口拿 task_id，再用任务查询接口获取结果。

输入要求？

公网可访问视频 URL，格式与时长限制见文档。

和多视频合成的关系？