Skip to main content
APIPod 图片和视频生成采用异步模式。创建请求会快速返回公开 task_id，生成过程在该 HTTP 请求结束后继续执行。

​
生命周期

内部结果收尾阶段对外仍显示为 processing，客户端不需要处理独立的 finalizing 状态。

​
轮询端点

状态查询按认证账号隔离，不会返回其他账号拥有的任务。

​
轮询策略

  • 使用较短初始延迟，然后采用带随机抖动、有上限的指数退避。
  • 进入终态后立即停止轮询。
  • API 返回 Retry-After 时应遵循该值。
  • 启动后台轮询前先持久化 task_id。
  • 根据所选模型设置业务截止时间，不要假设所有模型都能在同一时长内完成。
  • 如果结果尚未成为可交付 URL，即使上游已完成，APIPod 仍会保持 processing 直到媒体收尾完成。

​
图片与视频错误字段

图片状态响应可在 data 中返回 error_code 和 error_message；视频状态响应通过 error 返回客户端安全消息；Webhook 使用 error 和可选 error_code。读取结果或错误字段前，应先判断 status。

使用 Webhook

无需持续轮询即可接收任务终态结果。

处理错误

统一处理 HTTP、同步和异步失败。