Async Media Workflow

画像と動画生成は時間がかかる場合があります。async 対応 request は task envelope を返し、client は task_id を保存して Task Retrieval を呼び出します。

Flow

1. image または video generation request を送る。
2. response が 202 の場合、task_id と poll_url を保存する。
3. recommended_poll_interval_ms または exponential backoff で polling。
4. state が success なら result を読む。
5. state が fail なら error を読み、回復可能な message をユーザーに表示する。

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 に渡します。