動画を照会

作成応答の output.task_id で照会します。返される output.task_id も公開タスク ID です。結果は output、使用量は usage にあります。

GET/api/v1/tasks/{task_id}

認証

bearerAuth

認証Bearer <token>

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

指定位置: header

パスパラメーター

task_id*string

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

長さ1 <= length

レスポンスボディ

`application/json`

curl -X GET "https://api.agtcloud.cn/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer your-api-key"

{
  "output": {
    "task_id": "task_example",
    "task_status": "PENDING"
  },
  "request_id": "REQUEST_ID"
}

状態と結果

`output.task_status`	意味と操作
`PENDING`	待機中
`RUNNING`	処理中
`SUCCEEDED`	成功。`output.video_url` を取得
`FAILED`	失敗。`output.code/message` を確認してポーリングを終了
`CANCELED`	取消済み。ポーリングを終了
`UNKNOWN`	不明な状態。成功として扱わない

約 15 秒間隔で照会し、全体のタイムアウトを設定してください。保存された記録はバックグラウンドで更新されます。再作成ではなく照会を使用します。

動画が生成されたら、結果 URL の失効前に速やかにダウンロードして保存してください。

使用量と時刻フィールド

usage.duration は合計使用時間で、動画入力時は入力と出力を含みます。input_video_duration/output_video_duration は小数の場合があるため、要求時間の整数ルールで解析しないでください。他に video_count、fps、SR、ratio が返る場合があります。

submit_time/scheduled_time/end_time は存在する場合に返される UTC+8 文字列で、Unix タイムスタンプではありません。request_id は追跡用で、タスク照会には使用しません。

照会エラー

HTTP 400 の task_not_exist では公開タスク ID、サイト、API Key のアカウントを確認します。これはタスクの UNKNOWN 状態とは異なります。HTTP 401 は Bearer 認証を確認してください。

エラーは output を含まず、トップレベルの code/message/request_id のみを返す場合があります。video 形式にはプラットフォーム照会を使用します。

Alibaba Cloud Wan 3.0 動画生成公式 API ドキュメントモデルのネイティブパラメーター、素材仕様、組み合わせルールを確認できます。

認証

パスパラメーター

レスポンスボディ

200application/json

400application/json

401application/json

状態と結果

使用量と時刻フィールド

照会エラー

`application/json`

`application/json`

`application/json`