はじめに
Kling 3.0 の画像から動画は、開始フレーム(image_url)とその後に何が起きるかを説明するプロンプトを受け取り、720p、1080p、4K のいずれかで 3〜15 秒を返します。last_image_url を設定すると終了フレームも固定でき、クリップは単に始まるだけでなく特定の場所へたどり着かなければならなくなります。generate_audio をオンにすると、映像と一緒にセリフと環境音が生成されます。
開始素材で Kling 3.0 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンや脚本 | Kling 3.0 テキストから動画 |
| 開始フレーム、任意で終了フレームも | Kling 3.0 画像から動画(現在のモード) |
| キャラクター写真と駆動クリップ | Kling 3.0 Motion Control |
主な機能とハイライト
開始フレーム、設定すれば終了フレームも
クリップはあなたの画像のままの状態で始まります。last_image_url を加えると、可灵は開放的な結末ではなく、そのフレームへ向けて動きます。当社の霧に包まれた桟橋の歩行のテストでは、クリップの最後のフレームが終了画像とほぼ一致し、赤いスカーフまで再現されました。
フレームが見た目を決め、プロンプトが動きを決める
衣装や舞台はすでに開始フレームが固定しているため、動作、カメラ、音だけを描写してください。当社のガソリンスタンドの雷の例は、フレームにある女性やガソリンスタンドを一度も描写し直さず、雷、雨の中への歩行、雷鳴だけを加えています。
アスペクト比はフレームに従う
ここに独立した aspect_ratio のフィールドはありません。出力は開始画像の形――横長のランドスケープから縦長のポートレートトリミングまで――をそのまま取ります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 開始フレームの後に起きることだけを描写してください――動作、カメラ、そして音声をオンにする場合は音です。 1 文字以上 · 2500 文字以内 |
negative_prompt | いいえ | クリップに入れたくないもの(物、見た目、動き)を最大 2,500 文字で指定します。任意で、料金は変わりません。 2500 文字以内 |
image_url | はい | 開始フレーム。クリップはこの画像から始まり、アスペクト比もそこから取ります。 |
last_image_url | いいえ | 任意の終了フレーム。長いクリップでは、両端が固定される以上に中間がぶれることがあります。 |
resolution | いいえ | 720p、1080p、4K。上位階層ほど秒あたりの費用が上がります。 |
generate_audio | いいえ | 同じクリップに生成されたサウンドトラックを加えます。720p と 1080p では無音より秒あたりの料金が高くなりますが、4K では音声の有無で料金は変わりません。 デフォルト値: |
duration_seconds | いいえ | 丸秒単位で 3 から 15。価格を左右します。 |
shot_type | いいえ | single はほとんどの実行で 1 つのセットアップを保ちますが、それでも自発的にカットすることがあります。multi は可灵に自らマルチショットの編集を任せます。 |
multi_prompt | いいえ |
|
guidance_scale | いいえ | クリップがプロンプトにどれだけ忠実に従うかを 0〜1 で指定します(既定 0.5)。高いほど文面に沿い、低いほどモデルに自由度を与えます。 |
料金
出力秒数ごとに課金されます。解像度と音声の切り替えの両方が単価を変えます。
| 解像度 | 音声を生成: いいえ | 音声を生成: はい |
|---|---|---|
| $0.0672 / 秒 | $0.1008 / 秒 |
| $0.0896 / 秒 | $0.1344 / 秒 |
| $0.336 / 秒 | $0.336 / 秒 |
ユースケース
デザインどおりにキャラクターを続ける
人物が 1 本のクリップから次のクリップまで同じ見た目である必要があるときは、まず静止画を生成または選び、衣装と顔を再び運任せにする新しいテキストから動画のプロンプトを書く代わりに、ここでアニメーション化してください。
特定の結末でクリップを終える
ショットの最後の展開が重要なとき――保たれた表情、ドアに置かれた手、フォーカスに入ってくる人物――は、結末をモデル任せにせず終了フレームを設定してください。
商品やファッションの静止画を動きで試す
商品や服装の静止写真に、単純なカメラの動きのプロンプトを添えるだけで、静止画が動いたとき、そして音声をオンにしたときどう聞こえるかを確認するのに十分です。
プロンプトガイドと実践のヒント
フレームがまだ示していないものだけを描写する
当社のガソリンスタンドの雷の例は、静止画の後に起きること――閃光、トラックから離れる一歩、土砂降りへの歩行――だけに留めています。衣装や舞台を一度も繰り返し描写していません。どちらもすでに画像が固定しています。
連続性が重要なときはショットを固定する
15 秒を通すと、背景のディテールがずれることがあります。特定の物やレイアウトを固定しておく必要があるなら、開始フレームがクリップ全体を固定してくれると想定せず、「同じ赤いトラックが終始彼女の後ろに駐車されたままである」のように直接名指ししてください。
途切れない 1 つのテイクには「1 つの連続したショット、カットなし」と言う
当社のヨットの手すりの例は、最初の試みで第 2 のアングルにカットし、夕暮れから昼光へ移ってしまいました。プロンプトの冒頭にその一文と、光が一定であることの描写を加えると、再テストではフレーミングと色の両方がクリップ全体を通して保たれました。
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/3.0/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 リファレンスを参照してください。












