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

PixVerse 動画取得

作成時に返されるネイティブタスク ID で状態と動画結果を取得します。

GET/openapi/v2/video/result/{task_id}

認証

bearerAuth
認証Bearer <token>

プラットフォームの API Key を Authorization: Bearer your-api-key 形式で使用します。

指定位置: header

パスパラメーター

task_id*string

作成時に返される Resp.video_id。すべての桁を保持し、接頭辞を付けないでください。

一致パターン^[0-9]+$

ヘッダーパラメーター

Ai-trace-id?string

任意の一意なトレース値。省略時はプラットフォームが生成します。冪等性キーではありません。

レスポンスボディ

application/json

application/json

application/json

application/json

タスク状態の確認

HTTP 200 は取得リクエストに応答があったことだけを示します。まず ErrCode、次に Resp.status を確認します。5 は処理中で、3~5 秒間隔で取得できます。1 は成功で、Resp.url が動画 URL です。7 は審査失敗、8 は生成失敗で、どちらもポーリングを停止してください。

ネイティブタスク ID の全桁を保存してください。生成に時間がかかるだけで作成を繰り返さないでください。成功後は速やかに動画をダウンロードまたは転送してください。

PixVerse 動画取得 — 公式ドキュメント対応する上流プロトコルの定義を確認します。