Skip to content

Webhook 通知 ​

支持回调的视频模型可以在任务状态变化时通知你的服务,减少轮询。回调字段和事件载荷以所选模型的当前请求结构为准。

接收流程 ​

  1. 提供公网可访问的 HTTPS 地址。
  2. 快速返回 2xx,耗时处理放入内部队列。
  3. 使用任务 ID 做幂等处理,避免重复通知产生重复业务动作。
  4. 收到成功事件后,再按任务 ID 查询一次最终结果。

安全建议 ​

  • 校验平台提供的签名或验证信息(如所选模型支持)。
  • 不在回调 URL 中携带 API Key。
  • 记录任务 ID、事件时间和请求 ID,不记录敏感输入。
  • 对重复、乱序和延迟通知保持容错。

INFO

如果所选模型未提供 Webhook 字段,请使用 GET /v1/videos/{id} 轮询状态,不要自行猜测回调参数。

LAYSO AI API 文档