可灵 4.0 视频编辑
kwaivgi/kling-v4.0/video-edit
通过提示词和可选参考图片编辑视频,支持 720p、1080p,默认保留原音。
示例
参数
| 名称 | 类型 | 默认 | 约束 | 说明 |
|---|---|---|---|---|
| prompt *提示词 | textarea | — | ≤ 5000 chars | 描述你希望应用到视频中的编辑内容——例如更换主体、场景、天气或风格。在提示词中将视频写作 @Video1,将参考图片按数组顺序写作 @Image1、@Image2…… |
| images参考图片 | image_upload | — | image/* · 0–10 items | 可选参考图片(最多 10 张),用于将某个主体、物体或风格融入编辑结果中。 |
| keep_original_sound保留原声 | boolean | true | — | 保留源视频的原声。关闭时生成与画面同步的新音频。 |
| resolution分辨率 | select | 720p | 720p | 1080p | 输出分辨率。 |
| duration时长 | select | — | 3 ~ 30 · step 1 · 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | … | 输出时长为 3–30 秒的整数;留空时跟随源视频,最长 30 秒。 |
| aspect_ratio宽高比 | select | — | 16:9 | 9:16 | 1:1 | 21:9 | 输出视频的宽高比;留空时跟随源视频。 |
输出字段
| 字段 | 类型 | 说明 |
|---|---|---|
| videos | array<string> |
API
通过统一 REST API 调用本模型;在 API Keys 页获取密钥。
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/video-edit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"keep_original_sound": true,
"resolution": "720p"
}
}'
# 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-v4.0/video-edit",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"keep_original_sound": True,
"resolution": "720p"
}
},
)
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 1800s server-side.
deadline = time.time() + 1860
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-v4.0/video-edit", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
"keep_original_sound": true,
"resolution": "720p"
}
}),
});
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 1800s server-side.
const deadline = Date.now() + 1860 * 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 4.0 · 视频编辑
通过文字指令和可选参考图片编辑已有视频。请明确需要修改的内容,以及应保留的运动或构图。
输入参数
- prompt:字符串,必填。
- video:必填,单个视频 URL 字符串,不是数组。源视频至少 3 秒,超过 30 秒的部分会被截断。
- images:可选图片 URL 数组,最多 10 张。
- keep_original_sound:布尔值,默认 true。设为 false 可生成新的同步音频。
- resolution:"720p"(默认)或 "1080p"。
- duration:可选,3–30 的整数。省略时跟随输入时长,向上取整至整秒并以 30 秒为上限;没有固定 5 秒默认值。
- aspect_ratio:可选 "16:9"、"9:16"、"1:1"、"21:9"。省略时跟随源视频,不要传 "auto"。
限制与引用方式
源视频使用 @Video1 引用,@Image1、@Image2 等按 images 数组顺序引用图片。此接口不接收 videos 数组或参考音频上传。
标价与预扣积分
720p:每计费秒 $0.094;1080p:每计费秒 $0.141。
设输出秒数为 D,V = ceil(min(输入视频总秒数, 30))。含视频输入时,费用 = 单价 × (D + max(D, V))。例如 720p、输出 5 秒、输入视频 8.2 秒,V 为 9,费用为 $1.316,预扣 131.60 积分。
省略 duration 时 D=V。D=V=5 时,720p 为 $0.94,1080p 为 $1.41。等长情况下的每输出秒 $0.188/$0.282 不能直接用于输入长于输出的情况。
1 美元 = 100 Nami 积分。总积分向上取整到 0.01:积分 = ceil(美元费用 × 10000) / 100。以上为标价,不计促销折扣。
参考图片、宽高比和保留原声设置均无额外收费。
MaaS 参数映射
video 在 MaaS 中保持单个字符串,images 保持数组。跟随输入时,应保留 duration、aspect_ratio 的省略状态。 其余已列字段在 MaaS 中保持同名;duration 必须为整数,支持 keep_original_sound 的接口使用布尔值。数组顺序保持不变。
Nami API
使用 Authorization: Bearer YOUR_NAMI_API_KEY 和 Content-Type: application/json,向以下地址发送 POST 请求:
https://www.namifusion.com/api/v1/marketplace/run/kwaivgi/kling-v4.0/video-edit
请求体示例:
{
"input": {
"video": "https://example.com/source-video.mp4",
"images": [
"https://example.com/jacket-reference.jpg"
],
"prompt": "Change the jacket in @Video1 to match @Image1. Preserve the original subject motion, camera movement and background.",
"keep_original_sound": true,
"resolution": "720p"
}
}
请将 example.com 地址替换为可公开访问的素材 URL。取得 task_uuid 后,使用相同鉴权轮询 GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}。成功后从 output.videos 读取生成视频 URL 数组。
相关模型
VT 唇形同步
VT 唇形同步通过翻译后的视频、翻译后音频、翻译后字幕时间轴,以及原始视频和原始字幕时间轴,对翻译后的视频进行口型同步。
Kling Omni Video O3
Kling Omni Video O3 参考到视频模型可通过多个视角的角色、道具或场景参考生成创意视频。提取主体特征并创建新的视频内容,同时保持帧间身份一致性。支持音频生成。即用型 REST API,性能最佳,无冷启动,价格实惠。
Kling Omni Video O3
Kling Omni Video O3 参考到视频模型可通过多个视角的角色、道具或场景参考生成创意视频。提取主体特征并创建新的视频内容,同时保持帧间身份一致性。支持音频生成。即用型 REST API,性能最佳,无冷启动,价格实惠。
Kling 3.0 Standard 动作控制
Kling 3.0 Standard 动作控制将参考视频中的动作转移到静态图片中进行动画化。上传角色图片和动作片段(舞蹈、动作、手势),模型提取动作生成流畅、逼真的视频。提供即用型 REST 推理 API,性能最佳,无冷启动,价格实惠。
seedance-2-0 reference-to-video
Seedance 2.0 的“参考生视频”功能是视觉统一的终极方案。它能精准提取参考素材的艺术风格、光影基调或构图意向,并将其完美融入新生成的视频中,确保您的系列创作拥有高度一致的视觉语言。
black-forest-labs/flux-3/video-upscale 视频放大
默认 creativity=1,$0.79/秒起;creativity=0 为 $0.55/秒。按输入视频时长向上取整计费。FLUX Video Upscale 可对 MP4 视频进行放大增强,支持忠于原始内容或更具创意的细节重建,提供 1.5x 到 3x 可调缩放,并提升画面清晰度,适用于视频修复、社交内容、广告和制作流程。即开即用的 REST 推理 API,性能出色,无冷启动,价格实惠。
black-forest-labs/flux-3/video-extend-draft 视频续写
FLUX 3 Video Extend Draft 可基于必填的输入视频,结合提示词快速续写下一场景的草稿片段,支持可选的同步音频,并提供 5–20 秒的灵活时长,便于快速迭代。
black-forest-labs/flux-3/video-extend 视频续写
FLUX 3 Video Extend 可将输入视频延续生成新的 5–20 秒片段,并通过提示词控制后续动作、镜头运动、视觉风格、运动连贯性,以及可选的同步音频,支持 720P / 1080P 输出。提供开箱即用的 REST 推理 API,性能出色,无冷启动,价格实惠。