はじめに
Kling 4.0 Flash の動画編集には、既存のクリップと、変更内容を記した必須の指示を入力します。3〜20 秒の元動画を渡し、必要なら参照画像を最大 10 枚追加してください。出力は 720p で、元動画のシーン、被写体、動作、カメラワークを引き継ぎ、指定した編集を反映します。
出力の長さは元動画に合わせます。20 秒を超える素材は、その位置でカットされます。当社の天文台の衣装編集テストでは、5.04 秒の入力に対して出力も 5.04 秒でした。音声は既定で元動画から保持します。新しい同期音声を生成するには、keep_original_audio を false にしてください。
主な機能とハイライト
- 既存の演技やカメラワークを軸に、映像を変更できます。
- 特定の見た目を参考にしたい編集では、参照画像を最大 10 枚加えられます。
- 元動画のタイミングを出力に引き継ぎます。使用する元素材の上限は 20 秒です。
- 既定では元のサウンドトラックを残し、新たに同期音声を生成する選択もできます。
- 720p 出力の構図は auto、または対応する 4 種類のアスペクト比から選べます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 編集指示の入力が必須です。初期設定の文章はありません。 1 文字以上 |
video_url | はい | 3〜20 秒の元動画 1 本の URL が必須です。初期素材は設定されていません。 1 文字以上 |
reference_image_urls | いいえ | 編集を導く画像の URL を、任意で最大 10 件追加できます。アップロードした順に @Image1、@Image2 などと指定してください。 1 件以上 · 10 件以内 |
aspect_ratio | いいえ | 元動画の構図に合わせる場合は auto を使い、出力の形を指定する場合は 16:9、9:16、1:1、21:9 から選びます。この設定で編集料金は変わりません。 |
keep_original_audio | いいえ | 既定は true で、元動画の音声を保持します。false では新しい同期サウンドトラックを生成します。 デフォルト値: |
料金
$0.151 / 秒
編集は元動画の長さを整数秒に切り上げて課金し、課金秒数の上限は 20 秒です。5.04 秒の素材なら、出力が 5.04 秒のままでも 6 秒分の料金になります。プロンプト、参照画像、アスペクト比、音声の選択に個別の追加料金はありません。Kling の審査で拒否されると料金はかかりません。
ユースケース
- 天文台のクリップで、動作を残しつつエメラルド色のイブニングドレスを試せます。
- SNS 向けの短いシーンで、コートの色を変えた複数バージョンを比較できます。
- 撮影済みの動きと元のサウンドトラックを使い、見た目の異なる下書きを作れます。
プロンプトガイドと実践のヒント
- 「シーンとカメラの動きを維持する」のように、残すものから書いて編集の固定要素を定めてください。
- 多くのバリエーションを求める前に、「コートをチャコールグレーにする」など、一つの変更を具体的に指定してください。
- 「@Image1 に写るジャケットを使う」のように、追加画像の役割を編集内容に結び付けてください。
- 衣装を編集するときは、「エメラルド色のベルベットのドレス」など、素材と色の両方を説明してください。
- 新しいサウンドトラックには
keep_original_audioをオフにし、「音：低いモーターのうなりと夕方の風」などの指示を入れてください。
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-flash/video-edit",
"input": {
"aspect_ratio": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"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 リファレンスを参照してください。
