跳转到主要内容
当前为 API 预览。生成接口尚未接入供应商,成功认证后仍可能返回 503;不会创建任务或扣积分。

区分两种回调方向

供应商回调通知 APIstable 上游任务状态;用户 Webhook 通知你的应用平台操作结果。两者端点、凭据与校验方式独立。 回调支持属于供应商接入阶段。不能因为任务预览有通知字段,就假定生产签名 Webhook 已启用。

接收端保持幂等

  • 按文档针对原始请求体验证签名,再信任事件。
  • 按事件 ID 去重,容忍重试与乱序;不确定时查询权威任务状态。
  • 确认接收后尽快响应,后续应用处理放到后台。
  • 用户通知失败不会重新生成媒体,也不改变已结算积分。

轮询保留为恢复路径

缺少可靠回调的供应商可以轮询。APIstable 保存上游 ID 后安排后续检查。漏回调、Worker 重启或文件下载重试都不能直接产生另一笔生成。 你的应用也可轮询公开任务端点。设置等待上限并退避;停止等待不代表上游任务已取消。