> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apistable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 回调与轮询

> 生成状态、积分结算与通知投递独立处理。

> 当前为 API 预览。生成接口尚未接入供应商，成功认证后仍可能返回 503；不会创建任务或扣积分。

## 区分两种回调方向

供应商回调通知 APIstable 上游任务状态；用户 Webhook 通知你的应用平台操作结果。两者端点、凭据与校验方式独立。

回调支持属于供应商接入阶段。不能因为任务预览有通知字段，就假定生产签名 Webhook 已启用。

## 接收端保持幂等

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

## 轮询保留为恢复路径

缺少可靠回调的供应商可以轮询。APIstable 保存上游 ID 后安排后续检查。漏回调、Worker 重启或文件下载重试都不能直接产生另一笔生成。

你的应用也可轮询公开任务端点。设置等待上限并退避；停止等待不代表上游任务已取消。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.