当前为 API 预览。生成接口尚未接入供应商,成功认证后仍可能返回 503;不会创建任务或扣积分。
区分两种回调方向
供应商回调通知 APIstable 上游任务状态;用户 Webhook 通知你的应用平台操作结果。两者端点、凭据与校验方式独立。 回调支持属于供应商接入阶段。不能因为任务预览有通知字段,就假定生产签名 Webhook 已启用。接收端保持幂等
- 按文档针对原始请求体验证签名,再信任事件。
- 按事件 ID 去重,容忍重试与乱序;不确定时查询权威任务状态。
- 确认接收后尽快响应,后续应用处理放到后台。
- 用户通知失败不会重新生成媒体,也不改变已结算积分。