はじめに
Kling 3.0 Turbo のテキストから動画は、書いたシーンを 720p か 1080p、丸 3〜15 秒のクリップに変え、映像と同じ工程で音声を生成します。このエンドポイントに無音モードはありません。欲しいセリフと環境音をプロンプトに描写すれば、映像と一緒にレンダリングされます。
開始素材で Kling 3.0 Turbo のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーン | Kling 3.0 Turbo テキストから動画 |
| 承認済みの開始画像 | Kling 3.0 Turbo 画像から動画 |
主な機能とハイライト
音声は任意ではなく、それが重要な点
このエンドポイントから出るすべてのクリップに生成されたサウンドトラックが付きます。引用符で書いたセリフは話し言葉としてレンダリングされ、名指しした環境音――音楽、足音、交通量――は映像とミックスされて返ってきます。当社のテストでは、実行したすべてのクリップでセリフがプロンプトと一語一句一致しました。音声をオフにするフィールドはありません。無音の 1080p クリップが欲しい場合は、代わりに Kling 2.5 Turbo をお使いください。
1 つの連続したテイク、カット割りのフィールドなし
このエンドポイントにマルチショットの設定はなく、すべてのクリップが 1 つの途切れないテイクとして再生されます。つなぎ合わせたい複数の展開ではなく、ダンス、疾走と跳躍、カメラへの振り向きといった始まりから終わりまでの 1 つの明確な動作を書いてください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | ショットとして書いてください:誰がフレームにいるか、動作、カメラの動き、そして音――引用符付きのセリフと欲しい環境音です。音声は常にレンダリングされ、外す方法はありません。 1 文字以上 · 2500 文字以内 |
aspect_ratio | いいえ | 16:9、9:16、1:1。プロンプトを書く前に選び、そのフレームに合わせて被写体を配置してください。 |
resolution | いいえ | 720p か 1080p。上位階層ほど秒あたりの費用が上がります。 |
duration_seconds | いいえ | 丸秒単位で 3 から 15。解像度と一緒に価格を左右します。 |
料金
出力秒数ごとに課金されます。解像度と長さの両方が単価に影響します。
| 仕様 | 料金 |
|---|---|
| $0.112 / 秒 |
| $0.14 / 秒 |
ユースケース
ショートやリール向けのセリフのあるシーン
2 人が話す、笑う、セリフを交わすといったシーンはここでよく機能します。音声は後から吹き替えるのではなく、映像に同期して返ってくるためです。当社がテストしたキッチンのシーンでは、セリフ、背景音楽、鍋が煮える音がすべて同じファイルに収まり、投稿前に別途音声の工程を挟む必要はありませんでした。
音声が一致するアクション・ムーブメントクリップ
パルクール、ダンス、その他の身体的なアクションには、足音、衝撃音、呼吸が動きと同じファイルの中に組み込まれて届くため、別途フォーリーの工程を加える必要はありません。
最初からサウンドが必要なクイックターンアラウンドの SNS クリップ
音声は映像と同じ工程で生成されるため、フィードやリール向けにすぐ投稿する短いクリップに向いています。別途サウンドデザインの工程を待つと投稿が遅れてしまう場面です。
プロンプトガイドと実践のヒント
起きる順番どおりにショットを書く
プロンプトを被写体、動作、カメラ、音の順に構成してください。キッチンサルサのプロンプトは使える雛形です。誰が踊っていて何を着ているか、何をするか(回転、カウンターにぶつかる)、カメラ(ミディアムショット、穏やかなハンドヘルド)、そして音(音楽、笑い声、煮える鍋の音)の順です。
音は雰囲気ではなく動作に一致させる
汎用的な雰囲気のトラックではなく、フレームの中の何かが起こす音――コンクリートの上の足音、煮える鍋、スクーターのエンジン――を名指ししてください。当社のテストでは、目に見える動作に結びついた音のほうが、それを発生させるものがフレームにない環境音の合図より、映像と一貫して同期してレンダリングされました。
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/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 リファレンスを参照してください。











