はじめに
Vidu Q4 Preview Reference to video は、1〜15 枚の参照画像と最大 3 本の音声クリップから一つのシーンを作ります。Vidu Q4 Preview は、Vidu の Q4 動画モデルの一般公開プレビューです。クリップは 540p から 4k まで、5 種類のアスペクト比で 3〜16 秒、音声は映像と一緒に生成されます。このエンドポイントはフィルターが弱めで、中程度のレベル以上ではほとんどのリクエストが和らげられるか拒否されます。
手元の素材に合わせてモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 動かしたいフレーム | Vidu Q4 Preview Image to video |
| 人物、衣装、商品、場所の画像(任意で音声クリップ付き) | Vidu Q4 Preview Reference to video |
主な機能とハイライト
最大 15 枚の参照
人物、衣装、商品、場所をまとめて入力できます。私たちの実行では、顔、衣装、部屋が 1 つのシーンにまとまって返りました。
2 人とも見分けられる
2 枚のポートレートを参照にすると、同じショットで両方の顔が保たれました。
参照音声
最大 3 本の音声クリップが声を決めます。言葉はプロンプトから来るため、台詞は引用符で囲んで書いてください。
5 つの形と 5 つの段階
aspect_ratio は 16:9、9:16、1:1、3:4、4:3 から選べます。resolution は 540p から 4k までで、2k と 4k は 10-bit HEVC です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須、20,000 文字まで。シーンを書き、参照画像は "the woman from the first image" のように位置で指します。 1 文字以上 · 20000 文字以内 |
reference_image_urls | はい | 必須。人物、衣装、商品、場所の画像を 1〜15 枚。 1 件以上 · 15 件以内 |
reference_audio_urls | いいえ | 任意。声のクリップを最大 3 本(Vidu が求めるのは MP3 で、1 本 3〜12 秒)。 1 件以上 · 3 件以内 |
aspect_ratio | いいえ | 16:9(既定)、9:16、1:1、3:4、4:3。料金は変わりません。 |
resolution | いいえ | 540p、720p(既定)、1080p、2k、4k。1 秒あたりの料金はこれで決まり、2k は 1080p より高く、4k は 2k のおよそ 2 倍です。 |
duration_seconds | いいえ | 3〜16 の整数秒、既定は 5。解像度とあわせて 1 秒単位で課金されます。 |
generate_audio | いいえ | 既定でオン:台詞、効果音、環境音が映像と一緒に生成されます。音声トラックのないクリップにしたい場合はオフにします。 デフォルト値: |
seed | いいえ | 1 つずつ条件を変えながら、実行結果を比べやすくします。フレームまで同一のクリップになることは保証しません。 |
料金
選んだ解像度での出力 1 秒単位で課金されます。音声、参照画像の枚数、参照音声クリップの本数では料金は変わりません。拒否されたリクエストには課金されません。
| 仕様 | 料金 |
|---|---|
| $0.045 / 秒 |
| $0.095 / 秒 |
| $0.12 / 秒 |
| $0.19 / 秒 |
| $0.39 / 秒 |
ユースケース
ファッション・商品のシーン
モデル、衣装、ロケーションを 1 つのクリップに。
二人が写るカット
会話、到着、キス寸前の場面を、両方の顔を保ったまま。
声のあるキャラクター
ポートレート、音声クリップ、引用符内の台詞を組み合わせます。
プロンプトガイドと実践のヒント
位置で指す
"the woman from the first image" や "the robe from the second image" のように書きます。
台詞を書く
音声クリップは言葉を与えません。台詞を引用符で囲み、参照音声の声で話すと明記してください。
フィルターを知っておく
軽めのリクエストは通り、最大のレベルのプロンプト二つのうち一つも通りました。中程度以上は、当社のテストで残りが拒否されるか和らげられ、拒否された分には課金されません。これらの上限を超える場面では、人物を写したフレームから 画像から動画 をお使いください。
540p で下書き
まず 540p でプロンプトを試し、1080p で仕上げます。2k や 4k は HEVC ファイルを扱える場合だけ選んでください。
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": "vidu/q4-preview/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p"
}
}'
# 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 リファレンスを参照してください。












