Video
PixVerse V6
PixVerse V6 でテキスト、画像、2 枚のフレーム、参照画像、作成済みのクリップから 360p〜1080p の 1〜15 秒の動画を生成。秒単位で課金されます。
PixVerse V6 は PixVerse の動画モデルです。1 つのモデル ID で、テキストから動画、画像から動画、最初と最後のフレーム間のトランジション、複数画像の参照、作成済みクリップの延長という 5 つのモードに対応します。送信するフィールドによってモードが決まります。クリップは 360p、540p、720p、1080p の 1〜15 秒で、ネイティブ音声は任意で付けられます。リクエストを送信し、返されたタスク ID を保持して、完成した動画をタスクから読み取ってください。画像は URL で渡します。
モデル ID
| モデル ID | 入力 | 解像度 | 長さ |
|---|---|---|---|
pixverse-v6 | テキスト、画像 1 枚、最初と最後のフレーム、参照画像 1〜7 枚、完了済みの pixverse-v6 タスク | 360p、540p、720p、1080p | 1〜15 秒 |
現在の料金はモデルページをご覧ください。テキストや画像 1 枚からより精細な単一ショットを作る場合は、PixVerse V6 Maxをご覧ください。
クイックサンプル
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse-v6",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "540p",
"duration": 5,
"size": "16:9"
}'エンドポイント
POST https://api.seedrouter.ai/v1/videos/generations| ヘッダー | 値 |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
レスポンスはタスク({"id": "task_...", "status": "processing"})であり、完成した動画ではありません。結果は GET /v1/tasks/{task_id} をポーリングして取得してください。API キーはサーバー側のコードで保持してください。
パラメータ
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
model | string | 必須 | pixverse-v6 |
prompt | string | 必須 | 最大 5,000 文字。どのモードでも必須。 |
resolution | enum | 540p | 360p、540p、720p、1080p のいずれか。 |
duration | integer | 5 | 1〜15 秒。最初と最後のフレーム間のトランジションは 5 または 8 のみ。 |
size | enum | 16:9 | 16:9、4:3、1:1、3:4、9:16、2:3、3:2、21:9 のいずれか。テキストから動画と複数画像の参照で使用し、ほかのモードは画像の形に従います。 |
audio | boolean | false | ネイティブ音声を生成します。音声ありの単価で課金されます。 |
seed | integer | なし | 0〜2147483647。同じリクエストとシードで似た結果が得られます。 |
negative_prompt | string | なし | クリップに入れたくないもの。最大 2,048 文字。 |
watermark | boolean | false | 透かしを追加します。 |
motion_mode | enum | normal | normal のみ対応。 |
generate_multi_clip_switch | boolean | false | マルチクリップ生成。テキストから動画と画像から動画のみ。 |
image_urls | URL リスト | なし | 画像から動画。最初の画像を使用します。 |
first_frame_image | URL | なし | トランジションの最初のフレーム。last_frame_image と一緒に送信してください。 |
last_frame_image | URL | なし | トランジションの最後のフレーム。first_frame_image と一緒に送信してください。 |
img_references | URL リスト | なし | 複数画像の参照。画像 1〜7 枚。 |
extend_from_task_id | string | なし | 延長。自分の完了済み pixverse-v6 タスクの ID。 |
スキーマは厳格です。未知のフィールドは無視されず、拒否されます。callback_url は利用できません。代わりにタスクをポーリングしてください。
モード
送信するフィールドによってモードが決まります。1 回のリクエストで 1 つのモードのフィールドを送信してください。
| モード | 送信する内容 | 説明 |
|---|---|---|
| テキストから動画 | 画像や延長のフィールドなし | size で形を指定します。 |
| 画像から動画 | image_urls | 最初の画像からクリップが始まります。 |
| トランジション | first_frame_image + last_frame_image | 5 秒または 8 秒。 |
| 複数画像の参照 | img_references(URL 1〜7 個) | 画像内のキャラクター、物、シーンを組み合わせます。size で形を指定します。 |
| 延長 | extend_from_task_id | 自分の完了済み pixverse-v6 タスクの続きを生成します。 |
{
"model": "pixverse-v6",
"prompt": "The puppy slowly turns into a kitten, soft studio light.",
"first_frame_image": "https://example.com/puppy.jpg",
"last_frame_image": "https://example.com/kitten.jpg",
"duration": 5
}{
"model": "pixverse-v6",
"prompt": "The paper boat drifts on toward a lily pad.",
"extend_from_task_id": "task_...",
"resolution": "540p",
"duration": 5
}延長では元のクリップに新しい区間が続く結果が返り、新しい区間の duration だけに課金されます。私たちのテストでは、1 秒のクリップを 1 秒延長すると 2.1 秒の動画が返り、1 秒分として課金されました。
メディア入力
画像は公開されている HTTP(S) URL で渡します。Base64 の data URI は受け付けません。ファイルを自分のストレージにアップロードし、その URL を渡してください。20 MB 以下の JPG、PNG、WebP 画像を使用してください。
料金の要素
現在のレートはモデルの料金セクションをご覧ください。PixVerse V6 は動画の秒数で課金され、レートは解像度と音声生成の有無で決まります:
cost = duration × rate per second for the resolution and audio settingどのモードも秒単価は同じです。延長は新しい区間だけに課金されます。長さはリクエストの受理時に確定するため、確保される金額がそのまま課金額になります。最終的な課金額はアカウントの利用履歴で確認できます。失敗したタスクは課金されません。
出力スキーマ
送信するとタスクが返されます:
{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}タスクを取得する
GET https://api.seedrouter.ai/v1/tasks/{task_id}status が completed または failed になるまで、10〜20 秒ごとにポーリングしてください。ポーリング中のネットワークタイムアウトは生成の失敗を意味しません。タスク ID を保持して確認を再開してください。進捗確認のために別のタスクを作成しないでください。
完了したタスク
{
"id": "task_...",
"model": "pixverse-v6",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689640,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}私たちのテストでは、1 秒の 360p 16:9 クリップが MP4(H.264)、640 × 360 として、送信から 36〜45 秒で届きました。
エラー
タスク作成前に拒否されたリクエストは、HTTP エラーと error オブジェクトを返し、課金されません。受理後に失敗したタスクは、照会時に HTTP 200 と status: "failed"、そして error オブジェクトを返します。
コード・HTTP ステータス・リトライの指針は共通エラーカタログを参照してください。
{
"id": "task_...",
"model": "pixverse-v6",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}送信自体がタイムアウトした場合は、再送信の前にタスクを確認してください。最初のリクエストが受理されている可能性があります。
ヒント
- プロンプトで被写体、場所、カメラの動き、光を説明し、
audioがオンの場合は必要な音を記述してください。 360pまたは540pで下書きし、最終ショットは同じリクエストとseedを使って1080pでレンダリングしてください。- 縦長動画には、テキストから動画で
size: "9:16"、または縦長の画像を送信してください。 - 勝手なマークが入らないよう、
no text, no logosを加えてください。
