はじめに
Kling 4.0 テキストから動画は、書いたブリーフを 3〜30 秒のクリップに変えます。720p または 1080p で、16:9、9:16、1:1、21:9 のウルトラワイドから選べます。すべてのクリップには、同じ工程で生成されたステレオのサウンドトラックが付きます。引用符で書いたセリフ、効果音、環境音がそこに含まれます。音声の切り替えはなく、追加料金もありません。
開始素材で Kling 4.0 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンや脚本 | Kling 4.0 テキストから動画(現在のページ) |
| 開始フレーム、必要に応じて終了フレームと中間フレーム | Kling 4.0 画像から動画 |
| キャストに使う写真、クリップ、音声サンプル | Kling 4.0 参照から動画 |
主な機能とハイライト
一回の長回しで最長 30 秒
長さは 3〜30 秒の整数で、Kling 3.0 の上限の 2 倍です。長回しなら、ゆっくりしたクレーンや、セットを端から端まで歩くような場面も、短いクリップをつなぎ合わせずに描けます。
音声は常にオン
各クリップには 2 チャンネルのサウンドトラックが付きます。当社のテストでは、プロンプトの Sound: の行から、ドームのモーター音、風、ささやくセリフが映像のタイミングに合わせて返ってきました。
21:9 のウルトラワイド
16:9、9:16、1:1 に加えて、Kling 4.0 は本物の 21:9 のフレームを描きます。当社の 1080p ウルトラワイドのテストは 2200x940 で返りました。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 被写体、動き、カメラ、音を描写してください。セリフは引用符で囲み、音は独立した行に書いてください。 1 文字以上 |
aspect_ratio | いいえ | 16:9(既定)、9:16、1:1、21:9 のウルトラワイド。料金は変わりません。 |
resolution | いいえ | 720p または 1080p(既定は 720p)。1080p は秒単価が高くなります。 |
duration_seconds | いいえ | 3〜30 の整数秒(既定は 5)。料金を決めます。 |
料金
出力秒数ごとに課金されます。1080p は 720p より秒単価が高くなります。すべてのクリップにステレオのサウンドトラックが付き、追加料金はかかりません。拒否または失敗したリクエストには課金されません。
| 仕様 | 料金 |
|---|---|
| $0.216 / 秒 |
| $0.324 / 秒 |
ユースケース
音付きの導入ショット
風景、建物、夕暮れの道路。場所、光、カメラの動きを一つ、環境音を書けば、音がすでに入った状態で冒頭カットとして使えるクリップになります。
セリフを一つ入れた短い場面
動作の後に、引用符で囲んでセリフを置いてください。セリフは一クリップに一行の方が、重なり合う会話よりもモデルがタイミングを合わせやすくなります。
SNS 向けの縦型クリップ
9:16 を選び、被写体を中央の三分の一に収めてください。モデルは横長のショットを切り抜くのではなく、縦のフレーム向けに構成します。
プロンプトガイドと実践のヒント
起きる順に書く
被写体と衣装、動作、カメラの動き、雰囲気、そして独立した Sound: の行、という順で書いてください。当社の天文台の例はまさにその順になっています。
まず短く下書き、それから長く
生成には時間がかかります。3 秒のテストに 2〜4 分かかり、リクエストは並列ではなく一件ずつ処理されます。3〜5 秒の 720p で構図と動きを決めてから、長尺または 1080p を生成してください。
欲しい音を書く
音声は常に生成されるため、プロンプトに音を書かなくても無音にはなりません。モデルが選んだ音になります。欲しい環境音を書くか、"quiet room tone" と書いてください。
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# 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 リファレンスを参照してください。










