ガイド
メディアタスクフロー
Xenodia の画像・動画タスクに対する polling、timeout、recovery を実装する。
画像・動画生成はすべて task mode で動作し、同期 media response mode はありません。生成 endpoint は 202 と task envelope を返します。client は task_id を保存し、Task Retrieval で結果を取得します。
Flow
- image または video generation request を送る。
- response が
202の場合、task_idとpoll_urlを保存する。 recommended_poll_interval_msまたは exponential backoff で polling。stateがsuccessならresultを読む。stateがfailならerrorの公開 message を表示し、support 用に task ID と request ID を保持する。
Client behavior
- 無限 polling は避け、ユーザー待ち workflow には timeout を設定する。
- ユーザーが画面を離れる場合に備えて task ID を保存する。
- task retrieval は authenticated request にする。
403は task が現在の account に属さないことを意味する。404は task ID が存在しない、または利用不可であることを意味する。
Result handling
生成 asset URL は一時的な場合があります。result.data[].url を受け取ったら、早めに download、保存、または media pipeline に渡します。