视频编辑
Kling 4.0 Flash 的 video_edit:按提示词修改一段已有的视频,可以附上参考图和参考视频。
Kling 4.0 Flash 按提示词修改一段已有的视频,例如替换画面中的物体、改变风格,可以附上参考图和参考视频。
创建任务
POST
https://api.nanoapi.ai/v1/tasks用所有模型共用的创建任务接口,model 传 "kling-4.0-flash",mode 传 "video_edit"。
请求头
| 请求头 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <API Key>,见鉴权 |
Content-Type | 是 | application/json |
Idempotency-Key | 否 | 每个新任务一个唯一字符串,建议用 UUID(1–255 个字符),见防止重复创建 |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | kling-4.0-flash |
mode | string | 是 | video_edit |
video_url | string | 是 | 要编辑的视频:3–30 秒,720p 及以上(短边至少 720 像素),画面比例不超过 2.5:1,见素材 |
prompt | string | 是 | 描述如何修改,最长 8000 字符。可以用 @Video1(要编辑的视频)、@Video2 起(参考视频)、@Image1 起指代素材,见引用素材 |
image_urls | string[] | 否 | 最多 10 张参考图(例如要替换成的物体),见素材 |
video_urls | string[] | 否 | 最多 4 段参考视频(例如要模仿的动作),每段 3–30 秒,720p 及以上,画面比例不超过 2.5:1;与 video_url 的总时长不超过 30 秒,因此 video_url 为 30 秒时不能再带参考视频。见素材 |
aspect_ratio | string | 是 | 画面比例:auto、21:9、16:9、9:16 或 1:1。auto 跟随要编辑的视频的比例 |
resolution | string | 是 | 720p |
duration | integer | 否 | 输出时长(秒),3–20,按此计费,见价格。传入时以它为输出时长,与要编辑的视频时长无关;不传时输出时长跟随要编辑的视频,见不传 duration |
webhook_url | string | 否 | 任务成功或失败时通知该地址:https,最长 2048 字符,不能指向内网、回环或保留地址。见回调 |
不传 duration
- 输出时长:要编辑的视频的时长(取画面和音轨中较长的一个),向上取整到整秒,超出不到 0.05 秒的部分不计(10.02 秒按 10 秒计,10.06 秒按 11 秒计)。最长 20 秒:视频更长时按 20 秒输出。
- 计费:先冻结 20 × 每秒单价,任务成功后按实际输出时长扣费,多冻结的部分退回,见价格。
- 余额:可用余额(以及 API Key 的消费限额)须足够支付 20 秒的费用,即使视频更短也是如此,否则任务失败(
insufficient_balance或spend_limit_exceeded)。传入duration时只按请求的时长冻结。
把车换成参考图中的那辆,8 秒:
curl https://api.nanoapi.ai/v1/tasks \
-H "Authorization: Bearer $NANOAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-4.0-flash",
"mode": "video_edit",
"video_url": "https://example.com/source.mp4",
"image_urls": ["https://example.com/ref.jpg"],
"prompt": "Replace the car with the one in the reference image",
"aspect_ratio": "auto",
"resolution": "720p",
"duration": 8
}'带一段参考视频、不传 duration(输出时长跟随要编辑的视频):
curl https://api.nanoapi.ai/v1/tasks \
-H "Authorization: Bearer $NANOAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-4.0-flash",
"mode": "video_edit",
"video_url": "https://example.com/main.mp4",
"video_urls": ["https://example.com/dance.mp4"],
"prompt": "Edit @Video1: make her move like the dancer in @Video2",
"aspect_ratio": "auto",
"resolution": "720p"
}'响应:200 OK,返回新建的任务(字段说明)。保存 data.id,用它获取结果;任务创建后仍可能失败,见错误。
{
"code": 200,
"message": "success",
"data": {
"object": "task",
"id": "tk_01jbm3r8x5c2v9b6n4q7w1e3t5",
"model": "kling-4.0-flash",
"status": "queued",
"error": null,
"created_at": "2026-11-18T08:30:00Z"
}
}价格
费用 = 输出时长 duration × 每秒单价正在读取当前价格…
不传 duration(上面第二个请求)时,先冻结 20 × 每秒单价。任务成功后按输出时长 × 每秒单价扣费,多冻结的部分退回:要编辑的视频为 11 秒时,按 11 秒扣费,退回 9 秒的费用。此时 billing.billed_seconds 为输出时长。
计费秒数即请求的 duration,与要编辑的视频时长无关;不传 duration 时为输出时长。Kling 4.0 Flash 所有模式的价格见 Kling 4.0 Flash → 价格。当前单价见 GET /v1/products(产品 kling_flash,prices 中 mode 为 video_edit 的行),以任务的 billing.frozen 为准;冻结和扣费规则见计费。
错误
见 Kling 4.0 Flash → 错误。本模式的参数规则见上面的参数表。