はじめに
Kling 3.0 Turbo の画像から動画は、開始フレームと次に何が起きるかを説明するプロンプトを受け取り、一致する音声を生成した丸 3〜15 秒のクリップを返します。フレームがショット全体を固定します。Kling 3.0 Turbo は画像から人物、衣装、舞台を保ち、動き、カメラ、音声を新たに作り出します。
開始素材で Kling 3.0 Turbo のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーン | Kling 3.0 Turbo テキストから動画 |
| 承認済みの開始画像 | Kling 3.0 Turbo 画像から動画 |
主な機能とハイライト
開始フレームがクリップ全体を固定する
当社のテストでは、最初のフレームの顔と衣装がすべてのクリップを通して保たれました。夜市を手を引かれて走る一人称視点は全編を通して同じ相手の顔を保ち、スクーターに乗る 2 人は最初から最後までジャケットとバイクの色を保ちました。フレームの後に起きることだけを書いてください。
音は動きに同期して届く
このエンドポイントに aspect_ratio のフィールドはなく、クリップのフレームの形は元画像に従うため、アップロードする前に希望の形にトリミングしてください。音声は常にレンダリングされ、当社のテストでは目に見える動作に一致しました。スクーターのクリップではエンジン音と風、夜市のクリップでは市場のざわめきと呼びかけるセリフです。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | フレームの後に起きることだけを描写してください:動作、カメラの動き、そして音声は常にレンダリングされるためセリフか環境音です。 1 文字以上 · 2500 文字以内 |
image_url | はい | 開始フレーム。この画像の人物、衣装、舞台はクリップ全体を通して保たれます。 |
resolution | いいえ | 720p か 1080p。上位階層ほど秒あたりの費用が上がります。 |
duration_seconds | いいえ | 丸秒単位で 3 から 15。解像度と一緒に価格を左右します。 |
料金
出力秒数ごとに課金されます。解像度と長さの両方が単価に影響します。
| 仕様 | 料金 |
|---|---|
| $0.112 / 秒 |
| $0.14 / 秒 |
ユースケース
承認済みの静止画を、動く、スコア付きの 1 場面に変える
正確な見た目が重要なとき、シーン全体をゼロから描写するのではなく、すでに静止画で固定したキャラクター、商品、場所をアニメーション化してください。
1 枚のフレームから始まる POV クリップ
一人称視点の開始フレームと動作についての短いプロンプトがあれば、それに一致するセリフと環境音を伴う一人称のトラッキングショットには十分です。夜市のテストでは、手をつないで歩く場面全体を通して同じ相手の顔が保たれ、市場のざわめきと呼びかけるセリフが動きに同期して届きました。
カップルやデュオのショットに命を吹き込む
自転車に乗った、テーブルを囲んだ、一緒に歩くといった 2 人の静止画は両者の顔と服装を保ったまま、プロンプトが次に何をして何を言うかを供給します。テキストから動画で白紙のプロンプトから 2 人を描写し直すより速い方法です。
プロンプトガイドと実践のヒント
シーン全体ではなく次の展開を描写する
フレームがすでに見た目を設定しているため、プロンプトには動き、カメラ、音だけが必要です。被写体が次に何をするか、カメラがどう追うか、そして音声は常に生成されるため欲しいセリフか環境音です。フレームがすでに示している服装、乗り物、舞台を改めて描写すると、モデルが動作に使えるはずの語数を無駄にしてしまいます。
実際にフレーム内にある音源を名指しする
当社のテストでは、エンジン音、風、市場のざわめきなど目に見えるものに結びついた音のほうが、汎用的な雰囲気の指示より一貫してレンダリングされました。フレームにスクーターや人混みが映っているなら、それを映さない環境音を描写するのではなく、そのシーンが実際に立てる音を名指ししてください。
アップロードする前にトリミングする
ここにアスペクト比を選ぶフィールドはありません。出力は元画像の形をそのまま取ります。フレームの形が重要なら、アップロードする前に 16:9、9:16、正方形にトリミングしてください。
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-turbo/image-to-video",
"input": {
"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 リファレンスを参照してください。











