Xenodia Docs
指南

媒体任务工作流

为 Xenodia 图片和视频任务构建可靠的轮询、超时与恢复流程。

所有图片和视频生成统一使用任务模式,没有同步媒体返回模式。生成接口返回 202 和 task envelope;客户端应保存 task_id,再调用 Task Retrieval 获取结果。

Flow

  1. 提交 image 或 video generation request。
  2. 如果 response 是 202,保存 task_id 和 poll_url。
  3. 按 recommended_poll_interval_ms 或指数退避 polling。
  4. state 为 success 时读取 result。
  5. 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。

本页内容