AGTCloud API Docs
ガイドAPIリファレンス連携とリソース更新とヘルプ
動画生成Wan

タスク照会 · 旧形式

旧形式の応答で Wan 3.0 タスクを照会します。

このパスは code/message/data で旧タスクを返します。新規連携はプラットフォーム照会 APIを推奨します。応答構造は互換ではありません。

GET/v1/video/generations/{task_id}

認証

bearerAuth
認証Bearer <token>

プラットフォーム API Key を使用:Authorization: Bearer your-api-key。

指定位置: header

パスパラメーター

task_id*string

プラットフォームが返す公開タスク ID。文字列として保存し、照会とダウンロードに使用します。request_id や入れ子の上流タスク ID は使用しません。

長さ1 <= length

レスポンスボディ

application/json

application/json

application/json

旧形式の結果を読む

code: "success" は照会成功のみを表します。data.status も確認してください。

状態意味
NOT_START/SUBMITTED/QUEUED未開始、送信済み、または待機中
IN_PROGRESS処理中
SUCCESS成功。data.result_url を取得
FAILURE失敗。data.fail_reason を確認してポーリングを終了

data.progress は "100%" のような文字列で、プラットフォーム照会の数値とは異なります。created_at/updated_at/submit_time/start_time/finish_time は Unix 秒タイムスタンプで、未開始・未完了時の時刻は 0 の場合があります。例はタスク関連フィールドを示し、実際の応答には他のフィールドも含まれます。

照会とダウンロードには作成時の公開タスク ID、つまり本応答の data.task_id を使用します。data.data はネイティブ応答で、そのタスク ID はプラットフォーム照会・ダウンロードには使用しません。

ポーリングとエラー処理

約 15 秒間隔で照会し、全体のタイムアウトを設定して終端状態で停止します。完了後は速やかに保存してください。ポーリング停止で生成は取り消されません。

HTTP 400 の task_not_exist と HTTP 401 は照会リクエストのエラーであり、通常のタスク状態ではありません。ID、サイト、API Key を確認してからタスクデータを処理してください。

Alibaba Cloud Wan 3.0 動画生成公式 API ドキュメントモデルのネイティブ仕様を参照できます。プラットフォームのフィールドと応答は本ページに従います。