はじめに
PixVerse V6 テキストから動画は、書いたブリーフを、360p、540p、720p、1080p の 1〜15 秒のクリップに変えます。16:9 から 9:16 と 21:9 まで、8 種類のアスペクト比から選べます。被写体、動作、カメラを書いてください。プロンプトに書いたカメラの動きは再現され、PixVerse によると V6 はプロンプトから 20 種類以上の映画的なレンズとカメラの操作を理解します。generate_audio をオンにすると、映像と一緒に音声が生成されます。PixVerse は生成前にプロンプトと画像を審査し、断られたリクエストは失敗扱いとなり、課金されません。
開始素材で PixVerse V6 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーン | PixVerse V6 テキストから動画(現在のページ) |
| 開始フレーム、必要に応じて終了フレーム | PixVerse V6 画像から動画 |
| 配置したい人物、物、場所の写真 | PixVerse V6 参照から動画 |
| 続けたいクリップ | PixVerse V6 動画延長 |
| プロンプトまたは一枚の画像で、より高い画質が欲しい | PixVerse V6 Max |
| 写真一枚と、用意されたテーマのテンプレート(プロンプトは不要) | PixVerse V6 Effects |
主な機能とハイライト
一つの段落で、複数のフレーミング
当社のテストでは、ヴィンテージのターコイズ色のコンバーチブルで笑うドライバーについての一段落が、スカーフをなびかせる彼女のクローズアップで始まり、その後カメラが上昇して、海の上の崖道を走る車の広角の空撮に移りました。プロンプトではドローンが引いて上昇することを指定しました。クローズアップから空撮への切り替えは、モデルが決めたものです。
マルチショットの切り替え
shot_type は既定で single です。multi にすると、モデルがクリップを複数のショットに切り分けます。価格は変わりません。
8 種類のアスペクト比
16:9(既定)、4:3、1:1、3:4、9:16、2:3、3:2、21:9。アスペクト比では価格は変わりません。
必要なときだけ音声
generate_audio は既定でオフです。オンにすると、環境音、効果音、音楽、引用符で書いたセリフが生成されます。音声をオンにすると秒単価が上がります。
4 つの解像度
360p、540p、720p(既定)、1080p。当社のテストのクリップは 540p・1024x576 で、5 秒の映像にモデルの処理時間が約 41 秒かかりました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須。3〜5,000 文字。 3 文字以上 · 5000 文字以内 |
aspect_ratio | いいえ | 16:9(既定)、4:3、1:1、3:4、9:16、2:3、3:2、21:9。価格は変わりません。 |
resolution | いいえ | 360p、540p、720p(既定)、1080p。解像度が高いほど秒単価が上がります。 |
duration_seconds | いいえ | 整数秒、1〜15(既定は 5)。価格は秒単位です。 |
generate_audio | いいえ | 既定ではオフ。オンにすると、映像と一緒に音が生成されます。 デフォルト値: |
shot_type | いいえ | single(既定)または multi。multi にすると、モデルがクリップを複数のショットに切り分けます。 |
seed | いいえ | 任意の整数、0〜2147483647。一度に一つの変更を比べるのに役立ちます。 |
料金
出力の秒数ごとに課金されます。解像度と音声の切り替えで秒単価が変わります。アスペクト比、ショットの種類、seed では変わりません。失敗したリクエストや断られたリクエストには課金されません。
| 解像度 | 音声を生成: いいえ | 音声を生成: はい |
|---|---|---|
| $0.0222 / 秒 | $0.0311 / 秒 |
| $0.0311 / 秒 | $0.04 / 秒 |
| $0.04 / 秒 | $0.0533 / 秒 |
| $0.08 / 秒 | $0.1022 / 秒 |
ユースケース
冒頭と場面設定のショット
場所、光、カメラの動き一つ、雰囲気を書けば、シーンを始めるショットになります。当社の崖道の例は、まさに一段落でそれを行っています。
短いセリフを含むシーン
音声をオンにし、動作を書き、セリフは引用符で入れてください。同じプロンプトで欲しい環境音も書いておきましょう。
縦長とウルトラワイドのフレーミング
縦長のクリップには 9:16、3:4、2:3 を、ウルトラワイドには 21:9 を選んでください。秒単価はどのアスペクト比でも同じです。
プロンプトガイドと実践のヒント
起きる順に書く
場所と光を先に、次に被写体と衣装、動作、カメラの動き、雰囲気の順で書いてください。例の一文は、ゴールデンアワーの海岸の崖道、車と運転手、ドローンが引いて上昇する動き、暖かい 35mm フィルムの質感、という順になっています。
カメラの動きを書く
プロンプトに書いたカメラの動きは再現されるので、名前を付けてください。例:"the drone pulls back and rises"、"slow orbit"、"handheld push-in"。
seed で比べる
seed を使うと、一度に一つの点を変えながら実行結果を比較しやすくなります。同一のフレームになることは保証しません。
小さく下書きしてから仕上げる
価格は秒単位で、解像度によって変わります。短いクリップを低い解像度で構図を決めてから、最終版を 720p か 1080p で生成してください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pixverse/v6/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": false,
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。


