Kling 4.0 Flash
用提示词、首帧、参考图或一段已有的视频生成带声音的 720p 视频,按输出时长计费。
Kling 4.0 Flash(产品 kling_flash)用提示词、首帧、参考图或一段已有的视频生成带声音的 720p 视频。四种模式各有独立页面,介绍各自的参数、价格和请求示例:
mode | 说明 | 文档 |
|---|---|---|
text_to_video | 文生视频:只用提示词生成 | 文生视频 |
image_to_video | 图生视频:以一张图片为首帧生成 | 图生视频 |
reference_to_video | 参考图生视频:让参考图里的人物、物体出现在新视频里,也可以附上参考视频 | 参考图生视频 |
video_edit | 视频编辑:按提示词修改一段已有的视频 | 视频编辑 |
创建任务
https://api.nanoapi.ai/v1/tasks用所有模型共用的创建任务接口,model 传 "kling-4.0-flash",mode 传上述模式之一。所有模式共用的参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | kling-4.0-flash |
mode | string | 是 | text_to_video、image_to_video、reference_to_video 或 video_edit |
aspect_ratio | string | 是 | 画面比例:auto、21:9、16:9、9:16 或 1:1。auto 的效果因模式而异,见各模式的页面 |
resolution | string | 是 | 720p |
duration | integer | 条件必填 | 除 video_edit 外必填。输出时长(秒),3–20,按此计费,见价格。video_edit 未传时输出时长跟随要编辑的视频,见视频编辑 |
webhook_url | string | 否 | 任务成功或失败时通知该地址,见回调 |
所有参数均无默认值。
获取结果
3 秒的视频生成约需 1.3 分钟。传入 webhook_url 时通过回调获取结果,否则轮询 GET /v1/tasks/{task_id},间隔不少于 15 秒,直到 status 为 succeeded 或 failed(多个任务用列出任务的 ids 一次查询)。
| 字段 | Kling 4.0 Flash |
|---|---|
outputs[0].url | 输出视频:带声音的 MP4(16:9 时为 1280×720,24 fps) |
outputs[0].preview_url | 无声的压缩版,适合预览,见结果 |
billing.billed_seconds | 请求的 duration;video_edit 未传 duration 时为实际输出时长 |
input | 你提交的参数,包括 aspect_ratio、duration(video_edit 未传 duration 时不含 duration);prompt、image_urls、video_url、video_urls 仅在传入时返回 |
素材
素材以公开、可直接下载的 http(s) 链接传入:最长 4096 字符,不能指向 localhost 或内网、回环、保留地址,任务结束前必须保持可访问(包括有有效期的签名链接)。不提供上传接口。
| 参数 | 说明 | 适用模式 |
|---|---|---|
image_urls | 图片:首帧或参考图 | image_to_video(只能 1 张)、reference_to_video(最多 10 张)、video_edit(最多 10 张) |
video_url | 要编辑的视频 | video_edit |
video_urls | 参考视频 | reference_to_video(最多 5 段)、video_edit(最多 4 段) |
各模式必传哪些素材见对应页面。所有视频(video_url 和 video_urls 中的每一段)都须满足以下要求:
| 视频要求 | 不满足时任务失败 |
|---|---|
| 每段 3–30 秒 | video_too_short / video_too_long |
一个任务的所有视频总时长不超过 30 秒(因此 video_url 为 30 秒时,不能再带参考视频) | video_too_long |
| 720p 及以上(短边至少 720 像素) | invalid_media |
| 画面比例不超过 2.5:1(纯黑边不计入) | invalid_media |
图片或视频无法下载或无法读取(损坏、格式不支持)时,任务失败(invalid_media)。
Kling 4.0 Flash 的所有素材都在任务提交给生成服务后才读取(创建后几秒内),此时费用已冻结,上述要求在创建任务时均不检查;素材不可用时,冻结金额全额退回(失败任务的 started_at 可能为 null)。
在提示词中引用素材
prompt 中的写法 | 指代 |
|---|---|
@Image1 … @Image10 | image_urls 里的图片,按顺序编号 |
@Video1、@Video2… | reference_to_video:video_urls 里的视频,按顺序编号。video_edit:@Video1 是 video_url(要编辑的视频),@Video2 起依次是 video_urls 里的视频 |
价格
费用 = 输出时长 duration × 所选模式的每秒单价正在读取当前价格…
计费秒数即请求的 duration(3–20 秒),与图片和视频时长均无关。
- 带参考视频(
video_urls)的reference_to_video按video_edit的每秒单价计费,见参考图生视频 → 价格。 - 不传
duration的video_edit:先冻结 20 × 每秒单价,任务成功后按实际输出时长扣费,多冻结的部分退回,见视频编辑 → 价格。
除不传 duration 的 video_edit 外,费用只由请求参数决定,提交前即可算出。当前单价见 GET /v1/products(产品 kling_flash,prices 中每个模式一行,按该行的 mode 区分;带参考视频的 reference_to_video 使用 video_edit 那一行),以任务的 billing.frozen 为准;冻结和扣费规则见计费。
错误
请求错误
请求出错时返回 HTTP 错误,不会创建任务:
{
"code": 400,
"message": "Field required",
"error": {
"type": "invalid_request",
"param": "aspect_ratio",
"details": null
},
"request_id": "rq_01jb8z9x2c4v6b8n0m1q3w5e7r"
}| HTTP 状态码 | error.type | 说明 |
|---|---|---|
| 400 | invalid_request | 缺少必填参数、取值不符合本页或各模式页参数表的要求,或传了不支持的参数;param 指出是哪个参数 |
| 401 | invalid_api_key | API Key 无效、已删除或已重置 |
| 402 | insufficient_balance | 可用余额为 0 |
| 402 | spend_limit_exceeded | API Key 的消费限额已用满 |
| 403 | account_suspended | 账号已停用 |
| 409 | idempotency_key_reused | 同一个 Idempotency-Key 用在了请求体不同的请求上 |
| 429 | rate_limited | 请求过于频繁 |
| 500 | internal_error | 服务端错误,任务可能已创建 |
details 字段和处理方式见创建任务 → 错误。
任务失败
任务创建后仍可能失败:status 变为 failed,原因在 error 中,没有 HTTP 状态码。失败的任务不扣费,已冻结的金额全额退回。
{
"status": "failed",
"error": {
"type": "video_too_long",
"message": "The total duration of the videos must be at most 30 seconds."
}
}error.type | 说明 |
|---|---|
invalid_media | 图片或视频无法下载或无法读取(损坏、格式不支持),或视频低于 720p、画面比例超过 2.5:1 |
video_too_long | 某段视频(video_url 或 video_urls 中的)超过 30 秒,或一个任务的所有视频总时长超过 30 秒 |
video_too_short | 某段视频(video_url 或 video_urls 中的)短于 3 秒 |
content_policy | 提示词或素材不符合内容政策(不适宜内容、受保护的肖像或版权内容) |
insufficient_balance | 可用余额不足以支付本次费用;不传 duration 的 video_edit 须够支付 20 秒的费用 |
spend_limit_exceeded | 本次费用会超出 API Key 的消费限额 |
generation_failed | 生成失败 |
queue_timeout | 排队超过 30 分钟未开始 |
internal_error | 内部错误 |
程序判断请用 error.type;message 是面向开发者的英文说明,措辞可能调整。各原因的出现阶段、是否冻结过费用和 message 原文见失败原因。