はじめに
Vidu Q3 Spicy の画像から動画は、無検閲の開始フレームを動かします。動きの指示は任意で、音声は同じ処理で生成されます。
Vidu Q3 Spicy は Vidu Q3 を LoRA で調整した検閲なしのビルドで、画像から動画と video-extend のエンドポイントとして公開しています。このページでは画像から動画を扱います。内容は用意した開始フレームが担い、プロンプトは任意です。クリップは 540p、720p、1080p の 1〜16 秒です。
主な機能とハイライト
承認した画がそのまま動く
入力は画像だけなので、承認したシーンとテキストのプロンプトが描こうとするものの間にずれがありません。衣装、体、ポーズ、構図はすべて静止画から来て、モデルの仕事は動きです。検閲なしの開始フレームも和らげられることなく、送ったとおりに届きます。
静止画だけでも完結したリクエスト
プロンプトは任意です。フレームだけを送ればモデルが小さく自然な動きを推測し、ループならそれで十分なことがよくあります。カメラへ目線を上げる、衣服がずれるなど特定の瞬間がほしいときだけテキストを足し、画を説明し直すのではなく変化だけを書きます。
最長 16 秒の縦長クリップ
画面比率のフィールドがないので、9:16 の静止画は 9:16 のクリップになり、出力時に切り直されることはありません。最長 16 秒、最大 1080p と合わせれば、2 秒の断片ではなく始まりと終わりのある縦長の一場面を作れます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 必須です。動くのはこの静止画で、内容も出力の形もここで決まります。 |
prompt | いいえ | 任意です。拍、カメラ、音を書いてください。 |
duration_seconds | いいえ | 1〜16 の整数秒。ループには 1〜4 秒、16 秒ならひと続きが収まります。 |
resolution | いいえ | 540p、720p、1080p。既定は 720p です。 |
movement_amplitude | いいえ | auto、small、medium、large の 4 段階です。auto は開始フレームから判断します。 |
generate_audio | いいえ | 既定でオン。無音のループにするときは false にしてください。 デフォルト値: |
bgm | いいえ | クリップに BGM を付けます。既定でオンです。 デフォルト値: |
料金
| 仕様 | 料金 |
|---|---|
| $0.0665 / 秒 |
| $0.1425 / 秒 |
| $0.152 / 秒 |
ユースケース
他の API が拒否する検閲なしのクリップ
開始フレームはコンテンツフィルターなしで受け付けられ、送ったとおりに動きます。ほかの動画 API がプロンプトフィルターで拒否する素材もここでは動きます。内容は画像にあるので、結果は言葉を和らげて解釈し直したものではなく、承認したフレームに一致します。
コンパニオン・ロールプレイ動画
キャラクターの静止画 1 枚が、プロンプトを変えるだけで、見上げる、微笑む、肩があらわになるといった短いリアクションのセットになります。フレームが人物、衣装、セットをセット全体で安定させるので、コンパニオン向けのフィードに連続性が生まれます。
有料フィード向けの縦型ループ
9:16 の静止画は切り直しなしで縦長クリップになり、ループなら 1〜4 秒、シーンなら最長 16 秒です。540p でいくつか下書きを作り、出来の良い 2 本を 1080p で作り直しましょう。
プロンプトガイドと実践のヒント
先にフレームを作る
衣装、体、ポーズ、構図は画像のパスで決め、納品したい比率で書き出します。比率は 1:4〜4:1 の範囲に収めてください。あとから形を直すフィールドはないので、その静止画に写っているものがクリップの中身になります。
どれだけ動かすかを決める
movement_amplitude は auto、small、medium、large を受け付けます。auto は開始フレームから判断します。静かなシーンをもっと動かしたいときは上げ、呼吸だけを変えたいループでは下げてください。無音のループなら generate_audio を false にします。
付属の例を応用する
公開している例は duration_seconds 5、generate_audio true、resolution 720p です。
She finishes pouring, sets the flask down and lifts her eyes to camera with a small smile, steam rising from the cup, the yukata sliding a fraction lower on her shoulder. Paper shoji glow, evening cicadas, very slow push-in.
静止画 1 枚と動きのメモです。注ぐ動作、カメラへの視線、肩は文章で書き、人物を特定するものはすべてフレームから来ています。
安く試して、仕上げは 1 回
同じフレームから 540p で短いバリエーションを作り、うまく動いたものを選んで、納品用に 1080p で長めに作り直します。解像度の既定は 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": "vidu/q3-spicy/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"movement_amplitude": "auto",
"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 リファレンスを参照してください。











