はじめに
Kling O3 のテキストから動画は、画像や参照を一切使わずに、書いたプロンプトを 3〜15 秒のクリップに変えます。丸秒単位で長さを、720p から 4K まで解像度を選び、映像と一緒にネイティブ音声を生成するかどうかを決めます。prompt フィールドは最大 2,500 文字まで受け付け、被写体、動作、カメラ、そして音声をオンにする場合はセリフを配置するのに十分です。
開始素材で Kling O3 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンだけ | Kling O3 テキストから動画 |
| 承認済みの開始フレーム | Kling O3 画像から動画 |
| 最大 7 枚の参照写真 | Kling O3 参照生成動画 |
| すでにある動画 | Kling O3 video-edit |
主な機能とハイライト
自動でマルチショットをカットする
shot_type を multi にし、プロンプトに複数のショット――広角ショット、クローズアップ、ローアングル――を描写すると、Kling O3 は 1 本のクリップの中でその間をカットし、ショットをまたいで舞台と人物を一貫させます。当社の雨のタンゴの例は、3 つのショットを順に描写した 1 つのプロンプトで、完成したクリップはそれぞれの合図でカットしました。
同じ工程でのネイティブ音声
generate_audio をオンにすると、セリフ、効果音、環境音が後付けではなく映像と一緒に生成されます。引用符で書いたセリフは動作に合わせたタイミングで返ってきます。当社のジャズクラブの例では両方のセリフがプロンプトと一語一句一致しました。
720p から 4K まで、1 つのプロンプトで
3 つの解像度すべてが同じプロンプトからレンダリングされるため、ショットとセリフがうまくいくまで 720p で下書きし、それから採用するテイクを 1080p か 4K で再実行するのが通常のパターンです。解像度と音声の両方が価格を左右します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 被写体、動作、カメラ、そして音声をオンにする場合はセリフと音を描写してください。マルチショットのプロンプトでは、ショットに順番に番号を振ってください。 1 文字以上 · 2500 文字以内 |
aspect_ratio | いいえ | 16:9、9:16、1:1。ショットを書く前に選び、その形に合わせて人物とフレーミングを配置してください。 |
resolution | いいえ | 720p、1080p、4K。上位階層ほど秒あたりの費用が上がります。 |
generate_audio | いいえ | 同じ工程に生成されたサウンドトラック――引用符内のセリフ、効果音、環境音――を加えます。720p と 1080p では無音より秒あたりの料金が高くなりますが、4K では音声の有無で料金は変わりません。 デフォルト値: |
duration_seconds | いいえ | 丸秒単位で 3 から 15。解像度と音声とともに価格を左右します。 |
shot_type | いいえ | single は 1 つの連続したテイクを求めますが(絶対の保証ではなく、それでもカットが入る場合はプロンプトに「1 つの連続したショット、カットなし」を加えてください)。multi はモデルに自らプロンプトを複数のショットへカットさせます。 |
multi_prompt | いいえ |
|
料金
出力秒数ごとに課金されます。単価は解像度とネイティブ音声のオン・オフによって変わります。
| 解像度 | 音声を生成: いいえ | 音声を生成: はい |
|---|---|---|
| $0.0672 / 秒 | $0.0896 / 秒 |
| $0.0896 / 秒 | $0.112 / 秒 |
| $0.336 / 秒 | $0.336 / 秒 |
ユースケース
手元に画像がないシーンを開く
テキストから動画は言葉だけで足りる唯一の Kling O3 モードです。ショットが頭の中にしか存在しないとき、あるいは開始フレームを画像から動画に投入する前にどのフレーミングがうまくいくか素早く複数のテイクが必要なときに使ってください。
1 回のリクエストで複数のアングルからシーンをカバーする
4 つのアングルのために 4 つの別々のプロンプトを書く代わりに、シーケンスを一度描写し shot_type を multi にしてください。1 つのジョブから広角ショット、クローズアップ、リアクションショットを得るもっとも速い方法です。
長い編集の前にセリフのタイミングを試作する
音声は映像と一緒にレンダリングされるため、短いテキストから動画の下書きは、より長い、あるいは高解像度の実行に踏み切る前に、セリフが動作に対して自然に読めるかを確かめる速い方法です。
プロンプトガイドと実践のヒント
カットが欲しいときはショットに番号を振る
マルチショットのプロンプトでは、当社のタンゴの例のように、欲しい順にショットを並べ、それぞれのカメラ――広角、クローズアップ、ローアングル――を描写してください。Kling O3 はその構造を使ってどこでカットするかを決めます。
雰囲気だけでなくカメラの位置を名指しする
「鍵盤の端から見て両方の顔がはっきり見えるように」はモデルが従える実際の指示です。「ピアノの椅子の 2 人の男性」ではアングルが運任せになり、運任せのアングルは一方をもう一方の後ろに隠すことがあります。複数の人物が見え続ける必要があるときは、カメラが被写体に対してどこにあるかを言ってください。
固定したショットは明示的に求める
single は好みであって保証ではありません。Kling O3 はそれでも自らカットすることがあります。シーンが 1 つの途切れないテイクに依存するなら、プロンプトの最後に「1 つの連続したショット、カットなし、光は終始同じ」のような一文を加えてください。
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/o3/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"shot_type": "single",
"resolution": "720p",
"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 リファレンスを参照してください。












