Webhook 通知
支持回调的视频模型可以在任务状态变化时通知你的服务,减少轮询。回调字段和事件载荷以所选模型的当前请求结构为准。
接收流程
- 提供公网可访问的 HTTPS 地址。
- 快速返回
2xx,耗时处理放入内部队列。 - 使用任务 ID 做幂等处理,避免重复通知产生重复业务动作。
- 收到成功事件后,再按任务 ID 查询一次最终结果。
安全建议
- 校验平台提供的签名或验证信息(如所选模型支持)。
- 不在回调 URL 中携带 API Key。
- 记录任务 ID、事件时间和请求 ID,不记录敏感输入。
- 对重复、乱序和延迟通知保持容错。
INFO
如果所选模型未提供 Webhook 字段,请使用 GET /v1/videos/{id} 轮询状态,不要自行猜测回调参数。
