はじめに
Kling 4.0 画像から動画は、開始フレームを 3〜30 秒の 720p または 1080p のクリップにアニメーション化します。終了フレームを加えると終わりの位置を固定でき、最大 8 枚の中間フレームを順番に入れると、二つをつなぐ動きを指定できます。プロンプトは任意です。すべてのクリップにステレオのサウンドトラックが付きます。
開始素材で Kling 4.0 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンや脚本 | Kling 4.0 テキストから動画 |
| 開始フレーム、必要に応じて終了フレームと中間フレーム | Kling 4.0 画像から動画(現在のページ) |
| キャストに使う写真、クリップ、音声サンプル | Kling 4.0 参照から動画 |
主な機能とハイライト
開始フレーム、中間フレーム、終了フレーム
image_url が開始、last_image_url が終了、keyframe_image_urls が途中の節目を指定し、並べた順に現れます。当社のテストでは、望遠鏡をのぞく天文学者(開始)、接眼レンズに身をかがめる姿(中間)、腕を組んで手すりにもたれる姿(終了)が、三つのポーズを通る一続きの 3 秒の動きになりました。
形はフレームに従う
aspect_ratio を自動のままにすると、クリップは開始フレームの形を保ちます。16:9、9:16、1:1、21:9 を選ぶと上書きされます。
音声も一緒に付く
すべてのクリップには 2 チャンネルのサウンドトラックが付きます。プロンプトで音を書くと、その方向に誘導できます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | いいえ | 任意。開始フレームの後に起きることを描写してください。 1 文字以上 |
image_url | はい | 開始フレーム。JPEG または PNG。 |
last_image_url | いいえ | 任意の終了フレーム。クリップはこの画像で終わります。 |
keyframe_image_urls | いいえ | 任意の中間フレーム、最大 8 枚。開始と終了の間に、この順で現れます。 1 件以上 · 8 件以内 |
aspect_ratio | いいえ | auto(既定)は開始フレームの形を保ちます。16:9、9:16、1:1、21:9 で上書きします。 |
resolution | いいえ | 720p または 1080p(既定は 720p)。1080p は秒単価が高くなります。 |
duration_seconds | いいえ | 3〜30 の整数秒(既定は 5)。料金を決めます。 |
料金
出力秒数ごとに課金されます。1080p は 720p より秒単価が高くなります。すべてのクリップにステレオのサウンドトラックが付き、追加料金はかかりません。拒否または失敗したリクエストには課金されません。
| 仕様 | 料金 |
|---|---|
| $0.216 / 秒 |
| $0.324 / 秒 |
ユースケース
静止画を動かす
ポートレート、商品写真、以前のクリップの一コマ。次に起きることと雰囲気だけを書けば、服装や背景は元の画像から引き継がれます。
絵コンテを動きに
一つのショットの重要なポーズを描くか生成し、開始、中間、終了のフレームとしてアップロードすると、モデルがその間の動きを埋めます。
シーンを続ける
前のクリップの最後のフレームを次のクリップの開始フレームにすると、ショットをまたいでもキャラクターとセットを一貫させられます。
プロンプトガイドと実践のヒント
フレームを揃える
開始、中間、終了のフレームは、同じキャラクター、衣装、セット、カメラ位置を共有させてください。食い違うフレームは、カットやモーフィングを強いることになります。
絵ではなく動きを書く
画像にはすでに全体の見た目が写っています。プロンプトは動き、カメラの動き、音に使ってください。
キーフレームは少なく、明確に
中間フレームはそれぞれ、クリップが通らなければならない点になります。短いクリップなら一、二枚で十分です。数秒の間に多すぎると、動きが慌ただしくなります。
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/4.0/image-to-video",
"input": {
"aspect_ratio": "auto",
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 リファレンスを参照してください。










