PixVerse V6 API

PixVerse V6 参照から動画は、送った画像からクリップを作ります。一つのリクエストで要素を最大 7 つ使えます。PixVerse はこのモードを Fusion と呼んでいます。各要素には名前、一枚の画像、役割があります。役割は、人物、動物、物、商品なら subject、場所や背景なら background です。各要素を登場させたい場所に @name を書いてください。クリップは 1〜15 秒、360p〜1080p、8 種類のアスペクト比から選べます。PixVerse は生成前にプロンプトと画像を審査し、断られたリクエストは失敗扱いとなり、課金されません。

開始素材で PixVerse V6 のモードを選ぶ

要素に名前を付ける

各要素に 1〜30 文字の名前を付け、プロンプトで @name と呼んでください。当社のテストでは、maya（マスタード色のジャケットを着た赤毛の女性の写真）と trailer（クロームのトラベルトレーラーの写真）が、ガーランドライトの灯る夕暮れの中、トレーラーの前から彼女がホーローのマグを持って歩いてくるショットになりました。顔、髪、ジャケットは参照と一致し、トレーラーも一致しました。

名前の後にスペースを入れる

テストでは、"@trailer,"（名前の直後にカンマ）は名前が一致せず受け付けられませんでしたが、"@trailer and" は機能しました。失敗したリクエストには課金されません。@name の後にはスペースを入れて書いてください。

被写体と背景

role を人物、動物、物、商品なら subject（既定）、場所なら background に設定します。一つのリクエストで、両方を合わせて最大 7 つまで使えます。

小さなアーティファクトは起こり得る

サンプルでは、一コマだけ戸口に二人目の人物がほんの一瞬映りました。公開する前に、クリップを確認してください。

撮影したことのない場所に人物を置く

一つの要素にはポートレート、背景の要素には場所の写真を使い、動作をプロンプトに書きます。

車や商品の一貫性を保つ

車、トレーラー、商品に専用の要素を一つずつ与えると、作るどのクリップでも写真と同じに見えます。

短いシーンをキャストする

二つか三つの要素に名前を付け、どう出会うかを書き、カメラの動きを加えてください。

# 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/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://example.com/reference.png"
      }
    ],
    "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 リファレンスを参照してください。