はじめに
Kling 2.6 のテキストから動画は、書いたシーンを固定 1080p の 5 秒か 10 秒のクリップに変えます。設定できる resolution のフィールドはなく、出力は常に 1080p です。generate_audio は任意です。無音のレンダリングにしたければオフのままにし、映像と一緒にセリフ、音楽、環境音を生成したければオンにしてください。
開始素材で Kling 2.6 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーン | Kling 2.6 テキストから動画 |
| 承認済みの開始画像 | Kling 2.6 画像から動画 |
| 駆動クリップとキャラクター写真 | Kling 2.6 Motion Control |
主な機能とハイライト
音声は任意で、映像と一緒にレンダリングされる
generate_audio をオンにすると、引用符で書いたセリフと名指しした環境音が、映像と同じファイルの中で返ってきます。当社のダイナーのテストでは、重なり合う笑い声、ジュークボックスのドゥーワップ、カトラリーの音がすべてシーンに同期して届きましたが、グループの手ぶりはプロンプトで求めたよりもやや控えめに仕上がりました。
固定 1080p、選べる階層はない
このエンドポイントに resolution のフィールドはなく、すべてのクリップが 1080p でレンダリングされます。長さも 5 秒か 10 秒に固定されており、その中間の値のフィールドはありません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | ショットとして書いてください:誰がフレームにいるか、動作、カメラの動き、そして音声をオンにする場合は引用符付きのセリフと欲しい環境音です。 1 文字以上 · 2500 文字以内 |
negative_prompt | いいえ | 出てはいけないもの。2 人目の人物、字幕、モデルが何度も持ち込む小物などです。 2500 文字以内 |
aspect_ratio | いいえ | 16:9、9:16、1:1。プロンプトを書く前に選び、そのフレームに合わせて被写体を配置してください。 |
generate_audio | いいえ | 既定でオフです。オンにすると、映像と一緒にセリフ、音楽、環境音が生成されます。 デフォルト値: |
duration_seconds | いいえ | 5 か 10 秒――それ以外の値は受け付けられません。価格を左右します。 |
guidance_scale | いいえ | クリップがどれだけ厳密にプロンプトに従うかを 0 から 1 まで 0.01 刻みで指定します。既定は 0.5 です。 |
料金
出力秒数ごとに課金されます。音声をオンにすると秒あたりの費用が上がります。
| 仕様 | 料金 |
|---|---|
| $0.069 / 秒 |
| $0.138 / 秒 |
ユースケース
セリフ主導のグループシーン
1 つの部屋で数人が話し反応するシーンはここでよく機能し、部屋のトーンとセリフが映像と同じ工程でレンダリングされます。
Motion Control の駆動クリップとして再利用するきれいなテイク
1 人の演者が全身をフレームに収め、無地の背景と固定されたカメラで撮ると、別のキャラクターの駆動クリップとして Motion Control(character-animation)にそのまま渡せるテイクになります。
プロンプトガイドと実践のヒント
シーンを書く前に音声の有無を決める
generate_audio をオフのままにするなら、映像だけを描写してください。オンにするなら、引用符で書いたセリフと欲しい環境音をプロンプトの最後に添えてください。当社のテストでは、それらが表面的な層としてではなく、目に見える動作に結びついてレンダリングされることがわかっています。
駆動クリップには全身以外を求めない
無地の背景、固定されたカメラ、そして終始全身をフレームに収めるよう指示することが、Motion Control にとってもっともきれいな素材を生みます。studio-dancer-take の例はまさにこの方法で作られ、他の Kling ファミリーの駆動クリップとして 2 回再利用しました。
尺は書き始める前に 5 秒か 10 秒かを決める
長さは 2 つの値のどちらかしか取れないため、シーンを書く前に長さを決めてください。一言のセリフと短いリアクションなら 5 秒に無理なく収まります。複数の展開がある掛け合いや、間を置いてから決まるセリフなら、慌ただしく見えないよう 10 秒をフルに使ってください。
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/2.6/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"generate_audio": false,
"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 リファレンスを参照してください。











