Skip to main content
POST

認証

string
必須
すべてのエンドポイントは Bearer Token による認証が必要です。API Key の取得:API Key 管理ページ にアクセスして API Key を取得してください。リクエストヘッダーに以下を追加します:

リクエストパラメータ

string
必須
動画生成モデル名。pixverse-v6 で固定です。
boolean
デフォルト:"false"
動画タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
動画コンテンツの説明。最大 5000 文字。すべてのモードで必須です。
string
デフォルト:"540p"
動画解像度。課金に直接影響します。
  • 360p:SD
  • 540p:標準(デフォルト)
  • 720p:HD
  • 1080p:フル HD
指定外の解像度はパラメータエラーになります。
integer
デフォルト:"5"
動画の長さ(秒)。範囲は 1-15
始終フレームトランジションモードでは 5 または 8 秒のみ対応します。
string
デフォルト:"16:9"
動画のアスペクト比。テキストから動画および複数参照画像融合モードでのみ有効です。
  • 16:9:横長ワイド(デフォルト)
  • 4:3:横長 4:3
  • 1:1:正方形
  • 3:4:縦長 3:4
  • 9:16:縦型
  • 2:3:縦長 2:3
  • 3:2:横長 3:2
  • 21:9:シネマワイド
integer
デフォルト:"0"
ランダムシード。範囲は 0-2147483647。同一の prompt と seed で類似結果を再現できます。
string
ネガティブプロンプト。生成したくない内容を除外します。最大 2048 文字。
boolean
デフォルト:"false"
オーディオトラックを生成するかどうか。
  • true:オーディオを生成(課金単価が上がります)
  • false:オーディオなし(デフォルト)
boolean
デフォルト:"false"
動画の右下にウォーターマークを追加するかどうか。
  • true:ウォーターマークを追加
  • false:ウォーターマークなし(デフォルト)
string
モーションモード。
  • normal:標準モード(pixverse-v6 はこの値のみ対応)
fast は旧モデル専用です。pixverse-v6 で指定すると上流に拒否されます。
boolean
デフォルト:"false"
複数クリップ連続動画を生成するかどうか。テキストから動画および画像から動画モードのみ対応します。
  • true:複数クリップ連続動画を生成
  • false:単一クリップ(デフォルト)
array<url>
画像から動画モードの入力画像 URL 配列。先頭の 1 枚のみ使用されます。画像は公開アクセス可能な HTTP/HTTPS URL である必要があります。
url
始終フレームトランジションモードの開始フレーム画像 URL。last_frame_image と必ずペアで指定します。
url
始終フレームトランジションモードの終了フレーム画像 URL。first_frame_image と必ずペアで指定します。
array<url>
複数参照画像融合モードの参照画像 URL 配列。1~7 枚に対応します。このフィールドを指定すると複数参照画像融合モードがトリガーされます。
string
動画延長の元タスク ID。このフィールドを指定すると動画延長モードがトリガーされます。元タスクは現在のユーザーのものであり、モデルが pixverse-v6、ステータスが completed である必要があります。

生成モード

アダプタはリクエストフィールドに応じて自動的に対応する生成モードへ振り分けます。優先順位順にマッチし、最初に条件を満たしたものが採用されます。
すべての画像入力は公開アクセス可能な HTTP/HTTPS URL のみ対応します。base64 や Data URI には対応していません。ローカル画像のみの場合は、先にオブジェクトストレージへアップロードして URL を渡してください。

パラメータルール

レスポンス

integer
ステータスコード。成功時は 200
array
返却されるタスク配列。

タスク結果の取得

動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータス取得 エンドポイントで進捗と結果を確認してください。
cURL
ステータスが completed または failed になるまで、5 秒間隔のポーリングを推奨します。

成功結果の例

動画 URL のパスは data.result.videos[0].url[0] です。url フィールド自体も配列です。動画リンクは通常 24 時間で期限切れとなるため、早めにダウンロードまたは転送してください。

失敗結果の例

失敗時は通常 cost0 です。エラー理由は data.error.message から読み取ってください。

使用シナリオ

シナリオ 1:テキストから動画

シナリオ 2:画像から動画

シナリオ 3:始終フレームトランジション

シナリオ 4:複数参照画像融合

シナリオ 5:動画延長