はじめに
Kling 2.6 Motion Control は駆動動画の動き、表情、ジェスチャーを静止写真のキャラクターにコピーします。本人の鮮明な写真 1 枚と、演技を示す 3〜30 秒のクリップを渡すと、駆動クリップとまったく同じ長さの無音動画を 720p か 1080p で返します。
開始素材で Kling 2.6 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーン | Kling 2.6 テキストから動画 |
| 承認済みの開始画像 | Kling 2.6 画像から動画 |
| 駆動クリップとキャラクター写真 | Kling 2.6 Motion Control |
主な機能とハイライト
駆動クリップが指示しないすべてで本人の写真が優先される
当社のテストでは、1 人のダンサーが踊ったヒップホップのルーティンを、ネイビーの三つ揃えスーツの別の男性にマッピングしました。動きはステップごとに一致し、彼のスーツ、ローファー、顔、そして本人の写真にあったコンクリートのロフトは、駆動クリップの無地のスタジオの背景ではなく、すべて引き継がれました。
無音出力、長さは駆動クリップが決める
このエンドポイントに音声のフィールドはなく、結果は無音でレンダリングされます。duration のフィールドもありません。出力は常に駆動クリップの長さ（3〜30 秒）に一致するためです。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | いいえ | 任意。駆動クリップがまだ示していないもの――保つべき舞台、衣装のディテール、固定しておきたいもの――にだけ使ってください。 2500 文字以内 |
image_url | はい | アニメーション化するキャラクター：本人の鮮明な全身か半身の写真 1 枚。JPEG か PNG のみ。 |
video_url | はい | 駆動クリップ、3〜30 秒：コピーしたい動き、表情、ジェスチャー。結果はこのクリップとまったく同じ長さで、音声はありません。 |
resolution | いいえ | 720p か 1080p。上位階層ほど秒あたりの費用が上がります。 |
料金
駆動クリップの長さの秒数ごとに課金されます。出力は入力した動画とまったく同じ長さで再生されます。
| 仕様 | 料金 |
|---|---|
| $0.069 / 秒 |
| $0.112 / 秒 |
ユースケース
1 つの演技を複数のキャラクターで再利用する
1 本の駆動クリップを一度撮影または生成し、異なるキャラクター写真に対して実行することで、同じルーティン、歩行、ジェスチャーを毎回ゼロからアニメーション化することなく配役し直せます。
静止したキャラクターデザインに動きを加える
動きが意図的に見える必要があるとき、すでにデザインまたは生成したキャラクターに既存の演技で命を吹き込んでください。
プロンプトガイドと実践のヒント
コピーすべきものではなく、保つべきものを書く
動き、表情、ジェスチャーはすでに駆動クリップが運んでいます。prompt フィールドはそれが示せないもの――もっとも多いのは、どの舞台を保つか――のためにあります。駆動クリップの舞台ではなく、キャラクター自身の部屋を保つ、といった具合です。
駆動クリップと写真のフレーミングを合わせる
当社のテストは全身の駆動クリップと全身のキャラクター写真を組み合わせました。両者のフレーミングが大きく食い違う場合――例えば半身の写真を全身の駆動クリップで動かす場合――は、まず低い解像度で試す価値のある入力です。
両方の入力が十分に幅広いか確認する
キャラクター写真と駆動クリップのどちらも、各辺がおよそ 720 ピクセル以上必要です。それを下回る駆動クリップは、料金を払った後ではなく、ジョブが始まる前に拒否されます。駆動クリップは両方の辺を確認してください。通常と異なるクロップで撮影されていると、幅は通っても高さで失敗することがあります。
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/character-animation",
"input": {
"image_url": "https://example.com/reference.png",
"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 リファレンスを参照してください。
