视频编辑

Kling 4.0 按提示词修改一段已有的视频，例如替换画面里的物体、改变风格，可以附上参考图和参考视频。

创建任务

用所有模型共用的创建任务接口，model 传 "kling-4.0"。接口通常不到 1 秒返回，几秒内冻结费用，一般 1–5 分钟出片；任务结束后获取结果。

请求头

请求体

不传 duration

• 出片时长：要编辑的视频的时长（取画面和音轨里较长的那个），向上取整到整秒，多出不到 0.05 秒的不算（10.02 秒按 10 秒，10.06 秒按 11 秒）。
• 计费：先冻结 30 × 每秒单价，任务成功后按实际出片时长扣费，多冻结的部分退回，见价格。
• 余额：可用余额（以及 Key 的消费限额）要够 30 秒的费用，视频再短也一样，否则任务失败（insufficient_balance 或 spend_limit_exceeded）。传了 duration 就只冻结请求的时长。

把车换成参考图里的那辆，1080p，8 秒：

curl https://api.nanoapi.ai/v1/tasks \
  -H "Authorization: Bearer $NANOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0",
    "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": "1080p",
    "duration": 8
  }'

带一段参考视频、不传 duration（出片时长跟随要编辑的视频），720p：

curl https://api.nanoapi.ai/v1/tasks \
  -H "Authorization: Bearer $NANOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0",
    "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 是刚创建的任务，只有下面这几个字段，各字段的含义见创建任务的返回。保存 data.id，用它获取结果：任务成功后，查询结果或回调里的 data.outputs[0].url 就是成片。创建之后任务仍可能失败（例如素材下载不了），以查询或回调的结果为准。

{
  "code": 200,
  "message": "success",
  "data": {
    "object": "task",
    "id": "tk_01jbc4k7m2n9p5q8r3s6t1v4w7",
    "model": "kling-4.0",
    "status": "queued",
    "error": null,
    "created_at": "2026-10-30T08:30:00Z"
  }
}

价格

费用 = 出片时长 duration × 所选分辨率的每秒单价

正在读取当前价格…

例如 1080p、8 秒（上面第一个请求）是 8 × 1080p 的每秒单价。

不传 duration（上面第二个请求）时，先冻结 30 × 720p 的每秒单价。任务成功后按出片时长 × 每秒单价扣费，多冻结的部分退回：要编辑的视频 11 秒，就扣 11 秒、退回 19 秒的费用。这时 billing.billed_seconds 是出片时长。任务失败全额退回。

计费秒数就是请求的 duration，和要编辑的视频有多长无关；不传 duration 时是出片时长。价格会调整，当前单价请从 GET /v1/products 读取（prices 里 mode 是这个模式的行），不要写死；实际费用以查询任务返回的 billing.frozen 为准。Kling 4.0 所有模式的价格见 Kling 4.0 → 价格。

错误

创建请求出错：请求返回 HTTP 错误，任务不会创建。这个模式特有的：

创建接口的其他错误（401、402、429 等）见创建任务 → 错误。

任务失败：创建请求成功（200），任务之后变成 failed。这种情况没有 HTTP 状态码，原因在任务的 error.type，通过查询任务或回调拿到。

所有模式共用的失败原因（例如余额不够这个任务）见 Kling 4.0 → 错误，全部失败原因见失败原因。