はじめに
Kling O3 の video-edit は、何もないところから生成するのではなく、すでにある動画を変更します。元のクリップをアップロードし、変えるべきものだけ――季節、衣装、背景、スタイル――を描写するプロンプトを書いてください。省いたものはすべて撮影されたままです。任意で最大 4 枚の参照写真を加え、新しいキャラクター、衣装、物を持ち込めます。結果は元のクリップとまったく同じ長さ(3〜10 秒)で、720p か 1080p で再生されます。
開始素材で Kling O3 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンだけ | Kling O3 テキストから動画 |
| 承認済みの開始フレーム | Kling O3 画像から動画 |
| 最大 7 枚の参照写真 | Kling O3 参照生成動画 |
| すでにある動画 | Kling O3 video-edit |
主な機能とハイライト
名指ししたものだけを変える
プロンプトはシーン全体の描写ではなく変更のリストです。季節を雪に変える、あるいは衣装を冬のコートに切り替えると言えば、元のクリップのフレーミング、動き、テンポはそのまま引き継がれます。
長さと形は元動画に従う
設定する duration のフィールドはありません。編集済みのクリップはアップロードした動画の長さ(3〜10 秒)に一致し、解像度は他の 3 モードで使える 4K ではなく 720p か 1080p に限られます。
元動画に写っていないものへの参照写真
編集が元のクリップに含まれないもの――特定の新しい衣装、小道具、見た目――を導入する必要があるとき、プロンプトに描写した変更と一緒に、最大 4 枚の参照画像を加えてください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 何を変えるかを言ってください――被写体、衣装、舞台、スタイル、天候。言及しないものは編集済みのクリップでもそのままです。 1 文字以上 · 2500 文字以内 |
video_url | はい | 編集する元のクリップ、3〜10 秒、短い辺が約 720 ピクセル以上。編集された結果はこのクリップとまったく同じ長さで再生されます。 |
elements | いいえ | 編集後のクリップに登場させる名前付き被写体を 1 件指定します。名前、1 行の説明、同じ人物または物の写真 2〜4 枚(5〜30 秒の音声サンプルは任意)を指定し、プロンプトの被写体を登場させたい位置に @名前 と書きます。 1 件以内 |
reference_image_urls | いいえ | 任意、新しいキャラクター、衣装、物、スタイルを編集に持ち込むための最大 4 枚の参照写真。JPEG か PNG。 1 件以上 · 4 件以内 |
resolution | いいえ | 720p か 1080p。上位階層ほど秒あたりの費用が上がります。 |
keep_original_audio | いいえ | 元のクリップにもともと入っている音を編集結果に残します。既定でオンです。 デフォルト値: |
料金
元動画の長さ(3〜10 秒)の秒数ごとに、解像度に応じて課金されます。
| 仕様 | 料金 |
|---|---|
| $0.1252 / 秒 |
| $0.168 / 秒 |
ユースケース
クリップを別の季節や天候で再利用する
すでに気に入っているショットを取り、季節や天候だけを変えてください――夏から雪へ、晴天から雨へ――シーン全体を再撮影・再生成することなく。
承認済みのテイクの衣装や背景を差し替える
クリップのフレーミングと演技が正しいのに、衣装や被写体の背後の場所を変える必要があるとき、video-edit はその要素だけを更新します。
別所で生成したクリップを再スタイル化する
このモデルや別のモデルでのテキストから動画や画像から動画の実行から動画を持ち込み、プロンプトを使って、任意で参照写真に導かれながら異なるビジュアルスタイルへ押し進めてください。
プロンプトガイドと実践のヒント
シーンではなく変更のリストとして書く
クリップにすでに存在するものから始め、差分を名指ししてください。「季節を雪に変える」「代わりに彼にチャコールグレーのコートを着せる」のように。シーン全体の描写は、意図した以上のものをモデルにやり直させることになります。
まず元動画の寸法を確認する
元動画は短い辺でおよそ 720 ピクセル以上である必要があります。小さすぎるクリップは生成が始まる前に拒否されるため、参照写真も含むジョブの前にこれを確認してください。
編集が導入するものにだけ参照を加える
参照写真は、衣装、物、見た目など、元のクリップにない新しいものをショットに持ち込むためのものです。季節や色の変化のような純粋に描写的な変更には、通常プロンプトだけで十分です。
人物ごとに異なる衣装を明示する
クリップに複数の人物がいて、それぞれ異なる新しい衣装が必要なときは、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/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 リファレンスを参照してください。












