はじめに
Kling O3 の参照生成動画は、単一の開始フレームではなく、最大 7 枚の参照写真――キャラクター、衣装、物、場所――からショットをキャスティングします。プロンプトの中で参照に番号を振り(<<<image_1>>>、<<<image_2>>> など)、それぞれが何を貢献するかを言ってください。prompt フィールドは最大 2,500 文字まで受け付けます。丸 3〜15 秒の長さ、最大 4K の解像度、アスペクト比、そしてネイティブ音声を生成するかどうかを選びます。
開始素材で Kling O3 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンだけ | Kling O3 テキストから動画 |
| 承認済みの開始フレーム | Kling O3 画像から動画 |
| 最大 7 枚の参照写真 | Kling O3 参照生成動画 |
| すでにある動画 | Kling O3 video-edit |
主な機能とハイライト
複数の参照、1 つのショット
単一のフレームから始まる画像から動画と異なり、参照生成動画は最大 7 枚の別々の写真を受け取り、それぞれが示すものを組み合わせます。当社の食堂車の例は 3 枚を使いました。男性、部屋、物を、その 3 枚のどれも単独では描いていなかったシーンに一緒にキャスティングしました。
各参照が 1 つの役割を担う
プロンプトは役割を割り当てる場所です。「<<<image_1>>> は男性、コートと無精ひげを保って」がその顔と衣装をそのまま保ち、モデルが他の参照と平均化するのを防ぎます。
キャスティングされたシーンと一緒に生成される音
generate_audio は環境音、効果音、セリフを同じ工程で加えます。ひと言かふた言だけで描写した背景音への期待は現実的に持ってください――最終ミックスでは目立つ層ではなく静かにレンダリングされることがあります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 番号付けした各参照が何であるか(<<< |
reference_image_urls | はい | キャラクター、物、衣装、場所のための最大 7 枚の参照写真。JPEG か PNG。 1 件以上 · 7 件以内 |
reference_video_urls | いいえ | 任意の参照動画(1 本)で、新しいショットはその動き、カメラワーク、人物を参考にします。プロンプトでは <<< |
elements | いいえ | 4K 用の名前付き被写体を 1 件指定します。名前、1 行の説明、同じ人物または物の写真 2〜4 枚(5〜30 秒の音声サンプルは任意)を指定し、プロンプトやショットリストの被写体を登場させたい位置に @名前 と書きます。 1 件以内 |
aspect_ratio | いいえ | 16:9、9:16、1:1。構図が収まるよう、ショットを書く前に選んでください。 |
resolution | いいえ | 720p、1080p、4K。上位階層ほど秒あたりの費用が上がります。 |
generate_audio | いいえ | 同じ工程に生成されたサウンドトラック――引用符内のセリフ、効果音、環境音――を加えます。720p と 1080p では無音より秒あたりの料金が高くなりますが、4K では音声の有無で料金は変わりません。 デフォルト値: |
keep_original_audio | いいえ | 参照動画にもともと入っている音を結果に残します。既定でオンで、参照動画を渡したときだけ意味があります。 デフォルト値: |
duration_seconds | いいえ | 丸秒単位で 3 から 15。解像度と音声とともに価格を左右します。 |
shot_type | いいえ | single は 1 つの連続したテイクを求めます(絶対の保証ではありません)。multi はモデルが自分で複数のショットに切り分けます。 |
multi_prompt | いいえ |
|
料金
出力秒数ごとに課金されます。単価は解像度、ネイティブ音声のオン・オフ、参照動画の有無によって変わります。
| 仕様 | 料金 |
|---|---|
| $0.0672 / 秒 |
| $0.0896 / 秒 |
| $0.419 / 秒 |
| $0.0896 / 秒 |
| $0.112 / 秒 |
| $0.419 / 秒 |
| $0.1008 / 秒 |
| $0.1344 / 秒 |
ユースケース
一度も撮影されたことのない場所に人物を置く
顔にその専用の参照を、場所にもその専用の参照を与え、それらを組み合わせる動作を描写してください。どちらか一方の写真だけでは供給できない種類のショットです。
小道具や衣装をショットをまたいで一貫させる
キャラクターの参照と一緒に特定の物――アクセサリー、車、代名詞的な衣装――を参照すると、実行のたびにわずかに描き直されるのではなく、正しく繰り返し登場します。
3 つの計画された要素を軸にシーンを組み立てる
手紙、部屋、その読み手のように、特定の人物、特定の舞台、特定の物すべてが一緒に登場する必要があるショットでは、散文でゼロから描写する代わりに、参照で 3 つすべてを固定できます。
プロンプトガイドと実践のヒント
すべての参照に番号を振り、その役割を名指しする
各参照について順に「<<<image_1>>> は X、Y を保って」と書いてください。これが、参照がきれいに引き継がれるか他と混ざってしまうかを決める最大の要因です。
重複した 7 枚より鮮明な 3、4 枚を使う
参照は多いほど良いとは限りません。顔用に 1 枚、衣装用に 1 枚、部屋用に 1 枚といった、鮮明で異なる数枚のほうが、示すものが重複する 7 枚より同一性をよく保ちます。
音を背景の層として描写する
雨や列車の車輪のような環境音をセリフと一緒に求めるときは、ミックスの中で控えめに収まると想定してください。環境音を目立たせる必要があるなら、セリフの横に短く列挙するのではなく、明示的にそう言ってください。
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": "kling/o3/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"generate_audio": false,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p",
"shot_type": "single"
}
}'
# 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 リファレンスを参照してください。












