指南
媒体任务工作流
为 Xenodia 图片和视频任务构建可靠的轮询、超时与恢复流程。
所有图片和视频生成统一使用任务模式,没有同步媒体返回模式。生成接口返回 202 和 task envelope;客户端应保存 task_id,再调用 Task Retrieval 获取结果。
Flow
- 提交 image 或 video generation request。
- 如果 response 是
202,保存task_id和poll_url。 - 按
recommended_poll_interval_ms或指数退避 polling。 state为success时读取result。state为fail时读取error,向用户展示公开 message,并保留 task ID 和 request ID 供支持人员定位。
Client behavior
- 不要无限 polling;给用户等待场景设置 timeout。
- 用户离开页面时保存 task ID。
- 对 task retrieval 使用认证请求。
403表示 task 不属于当前 account。404表示 task ID 不存在或已不可用。
Result handling
生成资产 URL 可能是临时的。拿到 result.data[].url 后,尽快下载、转存或交给你的 media pipeline。