はじめに
Kling 3.0 Motion Control は、キャラクターの鮮明な写真 1 枚(image_url)と駆動クリップ(video_url、3〜30 秒)を受け取り、写真から顔、衣装、舞台を保ったまま、駆動クリップの動き、表情、手のジェスチャーをそのキャラクターで再現します。出力は駆動クリップとまったく同じ長さで、選んだ長さではなくその長さで課金されます。prompt は任意で、駆動クリップが示さないもの――舞台や見た目など――のために使います。
開始素材で Kling 3.0 のモードを選ぶ
| 手元にあるもの | モード |
|---|---|
| 書いたシーンや脚本 | Kling 3.0 テキストから動画 |
| 開始フレーム、任意で終了フレームも | Kling 3.0 画像から動画 |
| キャラクター写真と駆動クリップ | Kling 3.0 Motion Control(現在のモード) |
主な機能とハイライト
1 枚の写真、1 本の駆動クリップ、同じ演技を 2 回
ダンス、歩行、ジェスチャーの駆動クリップを 1 本記録またはライセンス取得し、必要な数だけキャラクター写真に対して実行してください。当社のテストでは、同じ駆動クリップのルーティンが、それぞれ自身の顔、服装、背景を保ったまま、2 人の異なるキャラクターでビートごとに一致して返ってきました。
結果は駆動クリップと同じ長さで再生される
設定する duration のフィールドはありません。出力の長さは常に駆動クリップ(3〜30 秒)に一致し、課金も同じ長さに従います。
720p か 1080p
Motion Control は 4K には対応していません。解像度は他の Kling 3.0 エンドポイントと同じように価格を変えます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | いいえ | 任意。駆動クリップが示さないもの――舞台、見た目、加えたいもの――にだけ使ってください。 2500 文字以内 |
negative_prompt | いいえ | クリップに入れたくないもの(物、見た目、動き)を最大 2,500 文字で指定します。任意で、料金は変わりません。 2500 文字以内 |
image_url | はい | アニメーション化するキャラクター:本人の鮮明な全身か半身の写真 1 枚。 |
video_url | はい | 駆動クリップ、3〜30 秒:コピーしたい動き、表情、ジェスチャー。結果はこのクリップと同じ長さで、その長さで課金されます。 |
resolution | いいえ | 720p か 1080p。上位階層ほど秒あたりの費用が上がります。 |
keep_original_audio | いいえ | 駆動クリップにもともと入っている音を結果に残します。既定でオンです。 デフォルト値: |
character_orientation | いいえ | 結果の中で人物がどちらを向くかを決めます。video(既定)は駆動クリップの人物に、image は写真の人物の向きに合わせます。 |
shot_type | いいえ | ショットの組み立て方です。customize(既定)は入力どおりに、intelligent はモデルが自分でショットを組み立てます。 |
料金
選んだ長さではなく、駆動クリップ(video_url、3〜30 秒)の長さを 1 秒単位で切り上げて課金されます。解像度が単価を変えます。
| 仕様 | 料金 |
|---|---|
| $0.1008 / 秒 |
| $0.1344 / 秒 |
ユースケース
1 つの演技を複数のキャラクターで再利用する
1 本の駆動クリップを一度振り付けまたはライセンス取得し、シリーズ内のすべてのキャラクター写真に適用してください。ダンスのルーティン、商品プレゼンターのジェスチャーのセット、繰り返される挨拶などを、毎回動きを撮り直すことなく使えます。
静止したキャラクター写真に本物の指示された動きを与える
言葉で動きを描写して特定のジェスチャーを期待するのではなく、Motion Control では正確な動きを駆動クリップとして一度見せ、それを正確に適用できます。
演技を新しい舞台にローカライズする
任意のプロンプトを使って、駆動クリップ自身の背景とは異なる場所にキャラクターを配置してください。動きそのものは変わりません。
プロンプトガイドと実践のヒント
動きは駆動クリップに任せる
プロンプトは動きを描写する必要がありません。駆動クリップがすでにそれを供給しています。クリップが示さないもの――部屋、衣装のディテール、雰囲気――にだけ使ってください。
キャラクター写真は鮮明で単一の被写体にする
1 人の鮮明な全身か半身の写真で、よく照らされ遮るものがないものが、Motion Control にもっとも明確な一致を与えます。キャラクターが部分的に隠れている、あるいは珍しい角度の写真は、モデルに推測させる部分を増やします。
両方の入力が十分な幅を持っているか確認する
キャラクター写真と駆動クリップの両方が、各辺でおよそ 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/3.0/character-animation",
"input": {
"character_orientation": "video",
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "customize",
"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 リファレンスを参照してください。












