视频精彩片段识别异步接口文档

异步识别视频精彩片段，通过回调通知结果，支持 requestId 对账。

接口地址与鉴权

参数名	说明
请求方式	POST https://la-raccoon.inaiai.com/triggers/webhook/{WEBHOOK_TOKEN}
Content-Type	application/json
{WEBHOOK_TOKEN}	鉴权凭证，按业务方单独发放，直接拼在 URL 末段

顶层参数

参数名	类型	是否必填	说明
query	object	是	业务参数，见 query 参数
response_mode	string	是	blocking = 同步等待，请求挂起直到结果返回
user	string	是	调用方标识。建议每个业务方使用固定值，便于用量统计与问题排查

query 参数

参数名	类型	是否必填	说明
type	string	是	能力类型。视频精彩片段固定填 video_highlight
desc	string	是	内容的标题/描述文本，作为识别时的语义参考；示例中以“标题：”前缀带入
video	string	是	视频地址，需我方服务可直接访问（见素材要求）
requestId	string	是	业务方自定义请求 ID，回调时原样带回，用于对账与幂等
notice_url	string	否	异步回调地址，任务完成后我方 POST 结果到该地址

请求示例

bash

curl -X POST 'https://la-raccoon.inaiai.com/triggers/webhook/{WEBHOOK_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": {
      "type": "video_highlight",
      "desc": "标题：夏日海边旅拍 vlog",
      "video": "https://your-cdn.example.com/files/xxxx/play.mp4",
      "requestId": "biz-20260804-0001",
      "notice_url": "https://your-domain.com/v1/video_highlight/notify"
    },
    "response_mode": "blocking",
    "user": "your-business-id"
  }'

接口响应

调用直接返回 200，"message": "异步调用成功请等待通知"，任务执行完调用回调地址（notice_url）通知结果。

json

{
  "message": "异步调用成功请等待通知"
}

回调通知数据

信息	说明
精彩片段列表	识别出的片段集合，可能多段
片段起止帧	每个片段的起始帧、结束帧，用于业务侧切片
高光帧	片段中最具代表性的一帧，可直接用作封面
requestId	原样返回，与请求对应

素材要求

项	说明
可访问性	video 地址需我方服务端可直接下载，不支持需登录/带鉴权/内网地址
协议	建议 HTTPS
格式	常见封装（mp4 等）
时长/体积上限	1h - 2h

同步接口

同步版本的视频精彩片段识别请查看精彩内容识别。