Kling 3.0 Standard
kwaivgi/kling-v3.0/motion-control
Kling 3.0 Standard Motion Control transfers motion from reference videos to animate still images. Upload a character image and a motion clip (dance, action, gesture), and the model extracts the movement to generate smooth, realistic video. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| image *Image | image_upload | — | 0–1 items | Supported image formats:.jpg /.jpeg /.png The size of the image file should not exceed 10MB, the width and height of the image should be no less than 300px, and the aspect ratio of the image should be between 1:2.5 and 2.5:1 |
| promptPrompt | textarea | — | ≤ 5000 chars | The positive prompt for the generation. |
| negative_promptNegative Prompt | textarea | — | ≤ 5000 chars | The negative prompt for the generation. |
| resolutionGeneration Mode | select | 720P | 720P | 1080P | |
| shot_typeShot Type | select | customize | customize | intelligent | Shot type for the generation. |
| element_listElement List | array<object> | — | 0–3 items | Element reference list. |
| ↳element_idElement Id | text | — | — | The prompt for this shot. |
| character_orientationCharacter Orientation | select | — | image | video | The duration of the generated media in seconds. |
| keep_original_soundKeep Original Sound | boolean | true | — | Whether to retain the original video sound |
API
Call this model through one unified REST API. Get a key on the API Keys page.
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);Documentation
Kling V3.0 Motion Control API
Effortless Motion Transfer for Realistic Video Animation
Kling V3.0 Standard Motion Control enables seamless motion transfer from reference videos to still character images. By uploading a character image and a motion clip (e.g., dance, action, gesture), this model generates smooth, realistic videos where your character mimics the movements in the reference video. With no cold starts and affordable pricing, Kling V3.0 is optimized for high performance and immediate results.
🚀 Key Features
- Motion Transfer: Extracts movements from reference videos and applies them to character images.
- Character Preservation: Maintains the visual identity of the character throughout the animation process.
- Flexible Orientation: Choose between image-based or video-based orientation for precise control.
- Audio Preservation: Option to retain the original sound from the reference video.
- Prompt Guidance: Use prompts to refine the animation style and motion transfer.
- No Cold Starts: Instant inference with optimized REST API performance.
🛠️ Technical Specifications
| Parameter | Description |
|---|---|
| Model Architecture | Motion Control (Image-to-Video) |
| Input Formats | Image: .jpg, .jpeg, .png (Max size: 10MB, Min dimensions: 300px, Aspect ratio: 1:2.5 to 2.5:1) |
| Output Formats | Video (Duration matches reference video: 3–30 seconds) |
| Orientation Modes | Image-based (Max duration: 10s) or Video-based (Max duration: 30s) |
| Prompt | Optional positive prompt to guide motion transfer |
| Negative Prompt | Optional negative prompt to exclude unwanted elements |
| Audio Options | Retain original sound (default: enabled) |
| Latency | Optimized for real-time inference |
💰 Pricing
| Resolution | Price per Second (USD) |
|---|---|
| 720P | 0.1260 |
| 1080P | 0.1680 |
| 4K | 0.3780 |
💡 Best Use Cases
- Character Animation: Bring static characters to life with dynamic, real-world movements.
- Virtual Presenters: Create talking or moving avatars for presentations or marketing.
- Dance Videos: Transfer dance moves to custom characters for entertainment or social media.
- Content Creation: Generate engaging videos with consistent character identity.
- Gaming & Entertainment: Animate game characters or mascots for promotional content.
🔗 Related Models
- Kling V3.0 Pro Motion Control: Enhanced quality and advanced features.
- DreamActor V2: Specialized motion transfer model.
- Kling V3.0 Std Image-to-Video: Standard image-to-video generation.
Related models
VT Lip Sync
VT Lip Sync synchronizes mouth movements for a translated video by using the translated target video, translated audio, translated subtitle timing, and the original source video with its original subtitle timing.
Kling Omni Video O3
Kling Omni Video O3 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Supports audio generation. Ready-to-use REST API, best performance, no cold starts, affordable pricing.
Kling Omni Video O3
Kling Omni Video O3 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Supports audio generation. Ready-to-use REST API, best performance, no cold starts, affordable pricing.
Kling Omni Video O1 Reference-to-Video
Kling Omni Video O1 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Ready-to-use REST API, best performance, no cold starts, affordable pricing.
Kling Omni Video O1 Reference-to-Video
Kling Omni Video O1 Reference-to-Video generates creative videos using character, prop, or scene references from multiple viewpoints. Extracts subject features and creates new video content while maintaining identity consistency across frames. Ready-to-use REST API, best performance, no cold starts, affordable pricing.
seedance-2-0 reference-to-video
The "Reference-to-Video" feature of Seedance 2.0 is the ultimate solution for visual stylistic unity. It precisely extracts artistic styles, lighting tones, or compositional intents from reference materials and seamlessly integrates them into newly generated videos, ensuring a highly consistent visual language for your creative series.
Alibaba WAN 2.6
Alibaba WAN 2.6 Reference-to-Video seamlessly transforms character, prop, or scene references—supporting both single and multi-view inputs—into high-quality video sequences. It excels at preserving identity, style, and layout while delivering fluid, coherent motion. Experience peak performance via our production-ready REST API, featuring zero cold starts and cost-effective pricing.