Kling 3.0 Standard モーションコントロール
kwaivgi/kling-v3.0/motion-control
Kling 3.0 Standard モーションコントロールは、参照動画の動きを静止画像に転送してアニメーション化します。キャラクター画像とモーションクリップ(ダンス、アクション、ジェスチャー)をアップロードすると、モデルが動きを抽出して滑らかでリアルな動画を生成します。すぐに使用可能な REST 推論 API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
サンプル
パラメータ
| 名前 | 型 | 既定 | 制約 | 説明 |
|---|---|---|---|---|
| image *画像 | image_upload | — | 0–1 items | 対応画像形式:.jpg /.jpeg /.png 画像ファイルのサイズは 10MB を超えないこと、画像の幅と高さは 300px 以上であること、画像のアスペクト比は 1:2.5 から 2.5:1 の範囲内であること。 |
| promptプロンプト | textarea | — | ≤ 5000 chars | 生成のためのポジティブプロンプト。 |
| negative_promptネガティブプロンプト | textarea | — | ≤ 5000 chars | 生成のためのネガティブプロンプト。 |
| resolution生成モード | select | 720P | 720P | 1080P | |
| shot_typeショットタイプ | select | customize | customize | intelligent | 生成するショットタイプ。 |
| element_list要素リスト | array<object> | — | 0–3 items | 要素参照リスト。 |
| ↳element_idElement Id | text | — | — | The prompt for this shot. |
| character_orientationキャラクターの向き | select | — | image | video | 生成されるメディアの長さ(秒)。 |
| keep_original_sound元の音声を保持 | boolean | true | — | 元の動画音声を保持するかどうか。 |
API
統一 REST API でこのモデルを呼び出せます。API Keys ページでキーを取得してください。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v3.0/motion-control" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"image": [
"https://assets.namifusion.com/uploads/image/e6d71928-36de-4d71-a26c-9b1b427a6dfd/2026-03-27/0847e5142a20.jpg?imageMogr2/thumbnail/600x/format/webp/quality/85"
],
"prompt": "Generate a smooth and natural animation of the character performing the uploaded dance sequence with vibrant colors and realistic motion.",
"negative_prompt": "Avoid jerky movements, unrealistic proportions, or overly saturated colors.",
"resolution": "720P",
"shot_type": "intelligent",
"character_orientation": "video",
"keep_original_sound": true
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v3.0/motion-control",
headers=HEADERS,
json={
"input": {
"image": [
"https://assets.namifusion.com/uploads/image/e6d71928-36de-4d71-a26c-9b1b427a6dfd/2026-03-27/0847e5142a20.jpg?imageMogr2/thumbnail/600x/format/webp/quality/85"
],
"prompt": "Generate a smooth and natural animation of the character performing the uploaded dance sequence with vibrant colors and realistic motion.",
"negative_prompt": "Avoid jerky movements, unrealistic proportions, or overly saturated colors.",
"resolution": "720P",
"shot_type": "intelligent",
"character_orientation": "video",
"keep_original_sound": True
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 300s server-side.
deadline = time.time() + 360
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v3.0/motion-control", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"image": [
"https://assets.namifusion.com/uploads/image/e6d71928-36de-4d71-a26c-9b1b427a6dfd/2026-03-27/0847e5142a20.jpg?imageMogr2/thumbnail/600x/format/webp/quality/85"
],
"prompt": "Generate a smooth and natural animation of the character performing the uploaded dance sequence with vibrant colors and realistic motion.",
"negative_prompt": "Avoid jerky movements, unrealistic proportions, or overly saturated colors.",
"resolution": "720P",
"shot_type": "intelligent",
"character_orientation": "video",
"keep_original_sound": true
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 300s server-side.
const deadline = Date.now() + 360 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);ドキュメント
Kling V3.0 Motion Control API
簡単なモーション転送でリアルな動画アニメーションを実現
Kling V3.0 Standard Motion Controlは、参照動画からモーションを抽出し、静止キャラクター画像に適用することで、スムーズでリアルな動画を生成します。キャラクター画像とモーション動画(例:ダンス、アクション、ジェスチャー)をアップロードするだけで、キャラクターが参照動画の動きを模倣する動画を作成できます。コールドスタートなし、手頃な価格、高性能で即時結果を提供します。
🚀 主な特徴
- モーション転送:参照動画の動きを抽出し、キャラクター画像に適用。
- キャラクター保持:アニメーション中にキャラクターの視覚的アイデンティティを維持。
- 柔軟な方向設定:画像ベースまたは動画ベースの方向を選択可能で、精密なコントロールを提供。
- 音声保持:参照動画の元の音声を保持するオプション。
- プロンプトガイド:プロンプトを使用してアニメーションスタイルやモーション転送を最適化。
- コールドスタートなし:最適化されたREST APIで即時推論を実現。
🛠️ 技術仕様
| パラメータ | 説明 |
|---|---|
| モデルアーキテクチャ | モーションコントロール(画像から動画) |
| 入力形式 | 画像:.jpg、.jpeg、.png(最大サイズ:10MB、最小寸法:300px、アスペクト比:1:2.5~2.5:1) |
| 出力形式 | 動画(参照動画と同じ長さ:3~30秒) |
| 方向モード | 画像ベース(最大長さ:10秒)または動画ベース(最大長さ:30秒) |
| プロンプト | モーション転送をガイドするためのオプションの正のプロンプト |
| ネガティブプロンプト | 不要な要素を排除するためのオプションのネガティブプロンプト |
| 音声オプション | 元の音声を保持(デフォルト:有効) |
| レイテンシ | リアルタイム推論のために最適化 |
💰 料金
| 解像度 | 秒単価 (USD) |
|---|---|
| 720P | 0.1260 |
| 1080P | 0.1680 |
| 4K | 0.3780 |
💡 主な利用ケース
- キャラクターアニメーション:静止キャラクターをリアルな動きで生き生きとさせる。
- バーチャルプレゼンター:プレゼンテーションやマーケティング用の話す・動くアバターを作成。
- ダンス動画:ダンスの動きをカスタムキャラクターに転送してエンターテインメントやSNS向けに活用。
- コンテンツ制作:キャラクターのアイデンティティを一貫して保持した魅力的な動画を生成。
- ゲーム&エンターテインメント:ゲームキャラクターやマスコットをアニメーション化してプロモーションコンテンツに活用。
🔗 関連モデル
- Kling V3.0 Pro Motion Control:品質向上と高度な機能を備えたプロモデル。
- DreamActor V2:モーション転送に特化したモデル。
- Kling V3.0 Std Image-to-Video:標準的な画像から動画生成モデル。
関連モデル
VT Lip Sync 口形同期
VT Lip Sync は、翻訳後の対象動画、翻訳後音声、翻訳後字幕タイミング、および元動画とその元字幕タイミングを使用して、翻訳後動画の口形を同期します。
Kling Omni Video O3
Kling Omni Video O3は、複数の視点からキャラクター、プロップ、またはシーンの参照を使用して創造的な動画を生成します。対象の特徴を抽出し、フレーム間でアイデンティティの一貫性を維持しながら新しい動画コンテンツを作成します。音声生成をサポート。すぐに使える REST API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
Kling Omni Video O3
Kling Omni Video O3は、複数の視点からキャラクター、プロップ、またはシーンの参照を使用して創造的な動画を生成します。対象の特徴を抽出し、フレーム間でアイデンティティの一貫性を維持しながら新しい動画コンテンツを作成します。音声生成をサポート。すぐに使える REST API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
Kling Omni Video O1 リファレンス動画生成
Kling Omni Video O1 リファレンス動画生成は、複数の視点からのキャラクター、小道具、またはシーンのリファレンスを使用してクリエイティブな動画を生成します。被写体の特徴を抽出し、フレーム間でのアイデンティティの一貫性を維持しながら、新しい動画コンテンツを作成します。すぐに使えるREST API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
Kling Omni Video O1 リファレンス動画生成
Kling Omni Video O1 リファレンス動画生成は、複数の視点からのキャラクター、小道具、またはシーンのリファレンスを使用してクリエイティブな動画を生成します。被写体の特徴を抽出し、フレーム間でのアイデンティティの一貫性を維持しながら、新しい動画コンテンツを作成します。すぐに使えるREST API、最高のパフォーマンス、コールドスタートなし、手頃な価格。
seedance-2-0 reference-to-video
Seedance 2.0の「リファレンス動画生成」機能は、ビジュアルの統一性を保つ究極のソリューションです。参考素材からアートスタイル、ライティング、構図の意図を正確に抽出。新しく生成される動画に完璧に融合させ、シリーズ作品を通して一貫した世界観を維持します。
Alibaba WAN 2.6
Alibaba WAN 2.6 Reference-to-Video は、キャラクター、小道具、またはシーンの参照画像(単一または複数視点)から、新しいビデオショットを生成します。アイデンティティ、スタイル、レイアウトを忠実に再現しつつ、滑らかで一貫性のある動きを実現。即利用可能な REST 推理 API は、コールドスタートなしの最高性能を誇り、圧倒的なコストパフォーマンスを提供します。