動画を照会
Wan 3.0 のプラットフォーム動画オブジェクトの進捗と結果を照会します。
作成 API が返した公開タスク ID で照会します。応答は単一の video オブジェクトです。
状態と動画 URL の読み取り
status | 意味と操作 |
|---|---|
queued | 待機中。後で再照会します |
in_progress | 処理中。後で再照会します |
completed | 生成完了。metadata.url を取得します |
failed | 生成失敗。利用可能な error を読み取り、ポーリングを終了します |
unknown | 未認識の状態。成功として扱いません |
応答の id を保存してください。照会は作成応答の冗長な task_id に依存しません。progress、completed_at、error の有無だけで成功と判断しないでください。completed_at は記録の更新時刻であり、状態は status で判断します。
成功後に動画 URL を保存するか、動画ダウンロード APIを使用します。この API はネイティブの output/usage を返しません。使用量はネイティブ照会を参照してください。
ポーリングとエラー処理
約 15 秒間隔で照会し、全体のタイムアウトを設定してください。保存されたタスク記録を読むため、短時間の再照会では同じ状態が返る場合があります。ポーリング停止では生成は取り消されません。
HTTP 400 の task_not_exist では、タスク ID のサイトと所有アカウントの API Key を確認します。HTTP 401 は認証を修正してから再照会します。生成成功は status で判断してください。