任务与轮询
图片和视频生成都采用异步任务模型；先提交，再轮询或等待 webhook 获取终态。
提交图片或视频请求后，服务端通常不会立即返回最终结果，而是先返回一个任务对象。
什么时候会进入任务系统
当前最典型的异步任务包括：
- 图片生成
- 视频生成
这也是当前对外 API 最核心、最稳定的一层能力。
任务状态
queuedrunningsucceededfailed
基本查询方式
curl https://www.yeehooai.com/v1/tasks/task_image_xxx \
-H "Authorization: Bearer sk_yeehoo_your_key"推荐轮询策略
- 图片任务：2 到 3 秒轮询一次
- 视频任务：5 到 10 秒轮询一次
- 进入
succeeded或failed就停止
结果读取建议
当任务进入终态后，建议以任务查询结果作为最终状态源，重点读取：
statusresultrequest_idbilling_transaction_id
轮询和 webhook 的关系
两者不是二选一，而是推荐并存：
- 轮询：最简单、最稳、适合联调和兜底
- webhook：更适合生产环境异步通知
轮询能力会一直保留，哪怕你已经开启 webhook，也仍然建议把轮询作为兜底能力。
常见错误理解
不要把任务系统理解成“会话系统”。
当前对外任务接口面向的是异步生成任务，不是开放完整的持久化对话会话管理。