Kling 4.0

Kling 4.0（产品 kling）用提示词、图片或一段已有的视频生成视频。四种模式各有一页说明，有各自的参数、价格和请求示例：

这一页是所有模式通用的规则。

创建任务

用所有模型共用的创建任务接口，model 传 "kling-4.0"，mode 传上面的一种。所有模式都有的参数：

• 必传参数：所有模式都要传 aspect_ratio、resolution，除了 video_edit 都要传 duration，没有默认值。prompt、image_urls、video_url、video_urls 是必填、可选还是不能传，每个模式不一样，见各模式的页面。
• 参数检查：参数不符合所选模式的规则时（例如 text_to_video 传了 image_urls、image_to_video 传了 video_urls、video_edit 没传 video_url），返回 400 invalid_request，param 是对应的参数名，任务不会创建。
• 响应：200 OK，和所有模型一样是精简的任务对象（见创建任务的返回），data.model 是 kling-4.0。保存 data.id，用它获取结果。
• 接口通常不到 1 秒返回，几秒内冻结费用。

获取结果

一般 1–5 分钟出片，个别 10 分钟左右。任务结束（成功或失败）后用下面任一方式拿结果：

• 回调（生产环境推荐）：创建时传了 webhook_url，任务结束时会把完整的任务推送一次，见回调。
• 轮询：用 data.id 调用 GET /v1/tasks/{task_id}，间隔 15 秒以上，直到 status 为 succeeded 或 failed；多个任务用列出任务的 ids 一次查询。

失败时冻结的钱全额退回，原因在 data.error.type，见错误。完整的字段见任务对象。

素材

所有素材都以公开的 http(s) 链接提交。不提供上传接口，请自行托管文件。链接最长 4096 字符，必须能直接下载，不能指向 localhost 或内网、回环、保留地址。

哪些必传见各模式的页面。所有视频（video_url 和 video_urls 的每一段）都要满足下面的要求：

图片或视频下载不了、读不了（损坏、格式不支持）时，任务失败（invalid_media）。

Kling 4.0 的所有素材都在任务提交给生成服务后才读取（创建后几秒内），这时已经冻结过费用，上面这些创建任务时都不检查；素材用不了时，冻结的费用全额退回。任务结束前所有链接都要保持可访问，有有效期的链接也不能提前过期。

在提示词里引用素材

价格

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

正在读取当前价格…

计费秒数就是请求的 duration（3–30 秒），和图片、视频有多长都无关。

• 带了参考视频（video_urls）的 reference_to_video 按 video_edit 的每秒单价计费，见参考图生视频 → 价格。
• 不传 duration 的 video_edit：先冻结 30 × 每秒单价，任务成功后按实际出片时长扣费，多冻结的部分退回，见视频编辑 → 价格。

例如 720p 的 text_to_video，duration 为 10 秒：冻结 10 × 它的 720p 每秒单价，成功后扣同样的金额，失败全额退回。冻结和扣费的通用规则见计费。

除了不传 duration 的 video_edit，价格只由请求参数决定，提交前就能算出来：当前单价从 GET /v1/products 读取，prices 每个模式、每个分辨率一行（看这一行的 mode；带参考视频的 reference_to_video 没有单独的行，用 video_edit 那一行），价格会调整，不要写死；实际费用以查询任务返回的 billing.frozen 为准。

错误

Kling 4.0 特有的错误和失败原因。创建任务的全部错误见创建任务 → 错误，全部失败原因见失败原因。

创建请求出错：请求返回 HTTP 错误，任务不会创建。

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

error.message 只说要求，不说你的视频多长，全部说明见每种原因的 message。invalid_media、video_too_short、video_too_long 是在冻结之后失败的：billing.frozen 是冻结的金额，全额退回（refunded 等于 frozen），billing.charged 为 "0.00"。