メインコンテンツへスキップ
POST
このエンドポイントは非同期で処理されます。送信後、返された task_id を使い、GET /v1/videos/generations/{task_id} でタスクの状態と結果を取得してください。

モデルの機能

PixVerse V6 Max は PixVerse V6 の高画質版です。テキストおよび単一画像からの動画生成のみをサポートし、どちらもモデル名 pixverse-v6-max を使用します。 開始・終了フレーム間のトランジション、複数画像の融合、動画延長には PixVerse V6 を使用してください。

リクエストヘッダー

string
必須
Bearer 認証:Bearer <token>。<token> は APIMart API Key です。

リクエストパラメータ

string
必須
pixverse-v6-max を指定してください。
string
生成する内容の説明。テキストから動画では必須で最大 5000 文字、画像から動画では省略可能で最大 2048 文字です。
string[]
入力画像 URL のリスト。画像から動画では画像を 1 枚のみ指定できます。2 枚以上を渡すと同期的に HTTP 400 が返されます。テキストから動画ではこのフィールドを省略してください。画像は HTTP(S) で外部からアクセス可能である必要があります。JPEG、PNG、WebP に対応し、ファイルは 20 MB 未満、各辺は 10000 ピクセル以下です。
integer
デフォルト:"5"
出力の長さ(秒)。1~15 に対応し、デフォルトは 5 です。
string
デフォルト:"540p"
出力解像度は 360p、540p、720p、1080p に対応し、デフォルトは 540p です。出力には上流モデルのネイティブサイズが使用され、実際に返されたサイズを基準とします。実測された代表例は 640×360、1108×832(幅 × 高さ、単位はピクセル)です。quality フィールドも使用できます。両方を指定した場合は resolution が優先されます。
string
解像度の互換フィールドで、指定可能な値は resolution と同じです。resolution がない場合のみ使用し、両方とも省略すると 540p になります。
string
デフォルト:"16:9"
テキストから動画でのみ有効です。16:9、9:16、4:3、3:4、1:1、2:3、3:2、21:9 に対応し、デフォルトは 16:9 です。画像から動画では常に入力画像のアスペクト比に従うため、このフィールドは無効です。
boolean
デフォルト:"false"
true でネイティブ音声を生成します。デフォルトは無音です。音声付き生成は秒単価が高くなります。リクエスト本文のトップレベルにある audio のみを認識します。metadata.generate_audio_switch では音声は有効にならず、音声付き料金も適用されません。
integer
ランダムシード。範囲は 0~2147483647 です。

画像から動画の例

サンプル URL を、実際に外部からアクセス可能な画像 URL に置き換えてください。指定できる画像は 1 枚のみで、出力のアスペクト比はその画像に従います。

タスクの照会

以下のリクエストのタスク ID を、送信時に返された task_id に置き換えてください。

料金

料金は、出力秒数に解像度と音声設定に応じた秒単価を掛けて計算します。音声付きと無音では単価が異なり、音声付きの方が高くなります。 resolution と quality のどちらも指定しない場合、出力・課金ともに 540p を使用します。 現在の単価はモデル料金照会エンドポイントで確認できます。

非対応の機能とパラメータエラー

以下のリクエストは同期的に HTTP 400 を返し、タスクは作成されず、課金もされません。