提交AI视频总结任务
更新时间:2025-03-24
接口描述
该接口用于批量提交AI视频总结任务
请求地址
https://spark.bokecc.com/api/video/summary/create
请求方式
GET
请求参数
以下请求参数需要进行THQS权限认证, 权限认证方式请参考THQS认证方式。
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
userid | String | 是 | ⽤户ID |
videoids | String | 是 | 视频ID,逗号分隔 |
callback | String | 否 | 回调地址 |
请求示例
https://spark.bokecc.com/api/video/summary/create?videoids=xxxx&userid=xxx&hash=8D89F1B20987BFEFF1D4FC46D8348F8F&time=1686205160
返回数据
名称 | 类型 | 说明 |
---|---|---|
accept | Array | 新增AI总结任务的视频ID列表,视频ID为加密长格式。 |
reset | Array | 重做AI总结任务的视频ID列表,视频ID为加密长格式。 |
success | Array | 已成功生成AI总结的视频ID列表,视频ID为加密长格式。 |
ongoing | Array | 正在生成AI总结的视频ID列表,视频ID为加密长格式。 |
返回示例
{
"accept": ["xxxxx", "xxxx"],
"reset": ["xxxx", "xxxxx"],
"success": [],
"ongoing": []
}
回调
回调参数
参数名 | 参数类型 | 约束 | 说明 |
---|---|---|---|
accountId | String | 必选 | 账号ID,加密长格式。 |
videoId | String | 必选 | 视频ID,加密长格式。 |
status | Integer | 必选 | AI总结结果状态。1=成功;-1=失败。 |
GET https://xxxxxxxx/xxxxx?accountId=xxxx&videoId=xxxx&status=1&hash=xxxxx&time=xxxxx HTTP/1.1
响应说明
发送回调请求时,接收到如下格式的JSON响应,表示回调成功,回调完成。
否则,会按照回调重试规则发起重试。
{
"result": "OK"
}
"OK"不区分大小写。
随着回调失败的重试次数增加,发起回调请求的时间间隔逐渐延长。
- retry_interval = 15 * Math.pow(4, retry_count - 1)
假设第一次回调时间为0秒,则每次重试的时间间隔如下:
| 重试次数 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | | :------- | ---- | ------- | -------- | --------- | ----------- | ------------- | ------------- | | 时间间隔 | 15s | 60s(1m) | 240s(4m) | 960s(16m) | 3840s(1h4m) | 15360s(4h16m) | 61440s(17h4m) |
回调支持重试7次,即最多会回调8次。