图片接口返回 201,为什么还没有图片?
POST /v1/images/tasks 返回 HTTP 201 只表示网关已受理图片任务并进入队列,不表示渲染已完成。客户端应将返回的 data.id 保存到订单或素材记录中,随后通过 GET /v1/tasks/{task_id} 轮询最终结果。
轮询任务生命周期
每次轮询之间按 data.poll_after_seconds(图片任务为 5 秒)等待,查询 GET /v1/tasks/{task_id} 不受速率限制。
queued或processing:界面继续展示处理中,等待data.poll_after_seconds后再次轮询。succeeded:从data.output.media[].url(或data.output.r2_url)读取图片链接,并尽快下载转存到自有存储。failed:任务失败时GET /v1/tasks/{task_id}仍返回 HTTP200,需读取data.error_code、data.error_message和data.retryable,并回到素材记录核对输入参数。
任务失败后的余额处理
已受理任务最终进入 failed 时,网关会自动退还创建时预扣的额度:usage.credits_charged 与 usage.credits_settled 均为 0,usage.credits_refunded 记录退回金额。

