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 标准运动控制支持从参考视频中无缝提取运动并应用到静态角色图片。通过上传角色图片和运动视频(如舞蹈、动作、手势),该模型生成流畅、逼真的视频,让角色模仿参考视频中的动作。无需冷启动,价格实惠,Kling V3.0 优化了性能并提供即时结果。
🚀 核心功能
- 运动转移:从参考视频中提取动作并应用到角色图片。
- 角色保留:在动画过程中保持角色的视觉身份。
- 灵活方向:支持基于图片或视频的方向选择,提供精确控制。
- 音频保留:可选择保留参考视频的原始声音。
- 提示词引导:使用提示词优化动画风格和运动转移效果。
- 无冷启动:优化的 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 |
💡 最佳应用场景
- 角色动画:让静态角色通过动态真实动作焕发生机。
- 虚拟主持人:为演示或营销创建会说话或移动的虚拟形象。
- 舞蹈视频:将舞蹈动作转移到自定义角色,用于娱乐或社交媒体。
- 内容创作:生成具有一致角色身份的吸引人视频。
- 游戏与娱乐:为宣传内容动画化游戏角色或吉祥物。
🔗 相关模型
- Kling V3.0 Pro Motion Control:增强质量和高级功能。
- DreamActor V2:专业运动转移模型。
- Kling V3.0 Std Image-to-Video:标准图片到视频生成。
相关模型
VT 唇形同步
VT 唇形同步通过翻译后的视频、翻译后音频、翻译后字幕时间轴,以及原始视频和原始字幕时间轴,对翻译后的视频进行口型同步。
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,具备极致性能与零冷启动特性,价格极具竞争力。