Vidu Q4 Preview 参照から動画 API の使い方：参照画像から動画生成統合ガイド（2026）

vidu/q4-preview/reference-to-video

プロンプトから3〜16秒の動画を生成します。参照画像は最大15枚、参照音声は最大3件まで任意で指定でき、アスペクト比選択、音声生成、540p〜4kに対応します。

パラメータ

必須項目は prompt のみです。images は0〜15件の画像URL、audios は0〜3件の音声URLを指定できます。両配列は省略または空配列にできます。seed=0 または省略でランダムシードを使用します。aspect_ratio の既定値は16:9です。このエンドポイントには enable_prompt_expansion はありません。

料金

合計料金=解像度の単価 × duration。duration は3〜16秒の整数です。既定値は720p、5秒、音声生成ありで、合計 $0.475（47.5クレジット）です。料金に影響するのは解像度と長さのみで、音声生成、シード、対応する参照素材やプロンプト拡張の追加料金はありません。1米ドル=100クレジット。定価は WaveSpeed と同額、アカウント割引は別途適用されます。

API

curl -X POST https://www.namifusion.com/api/v1/marketplace/run/vidu/q4-preview/reference-to-video \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "prompt": "Create a polished cinematic product video featuring the same matte black wireless headphones from the reference images on a clean studio set. Start with a slow rotating close-up that highlights the soft ear cushions and brushed metal details, then transition to a lifestyle shot of a young adult placing the headphones on while warm ambient light glows in the background. Keep the subject design fully consistent with the references, use smooth camera motion, realistic reflections, shallow depth of field, premium commercial styling, and subtle motion graphics for a modern brand ad.",
    "images": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/794a150611fc.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/1612d26e4530.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/2026/10/09/87a14c8b9623.jpeg"
    ],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5,
    "generate_audio": true,
    "seed": 123456
  }
}'

curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
  -H "Authorization: Bearer $API_KEY"

送信応答の task_uuid で completed または failed までポーリングします。成功時の output.videos は動画URLの配列です。

WaveSpeed