
Kling 4 API
支持文生视频、首帧,提供 720p / 1080p 分辨率。
- 文生视频
- 图生视频
- 参考图
kling-v4Playground
正在加载工作台…
人民币计费
正在读取人民币价格…
接入方式
API 接入
查看接入文档基础域名 https://api.icodeeasy.cc
- 创建视频任务
POST/v1/videos/generations - 查询视频任务
GET/v1/videos/tasks/{task_id} - 下载视频
GET/v1/videos/tasks/{task_id}/content - 删除视频任务
DELETE/v1/videos/tasks/{task_id}
API 示例
# 将 TASK_ID 设置为提交响应中的 task_id。
curl "https://api.icodeeasy.cc/v1/videos/tasks/$TASK_ID" \
-H "Authorization: Bearer $ICODEEASY_API_KEY"先在本地设置 ICODEEASY_API_KEY。示例中的参考素材链接或任务 ID 请替换为你自己的值。
调用参数
创建视频任务
| 参数 | 类型 | 说明 |
|---|---|---|
model必填 | string | 模型 ID,使用页首可复制的值。 |
prompt条件必填 | string | 文生视频必填。参考素材模式下,是否还需提示词取决于模型。 |
content条件必填 | array | 使用参考素材时提供。先上传素材,再在 content 项中填入返回的 asset_id。 |
resolution可选 | string | 支持 720p / 1080p。 |
ratio可选 | string | 支持 16:9 / 9:16 / 1:1 / 21:9 / auto。仅参考模式接受 auto,续写时省略。 |
duration可选 | integer | 输出时长 3–30 秒。编辑时省略则按输入视频时长向上取整。 |
generate_audio可选 | boolean | 音轨始终开启,若传值仅可为 true。 |
查询视频任务
| 参数 | 类型 | 说明 |
|---|---|---|
task_id必填 | string | 路径参数,使用创建任务后返回的 task_id。 |
下载视频
| 参数 | 类型 | 说明 |
|---|---|---|
task_id必填 | string | 路径参数,使用创建任务后返回的 task_id。 |
删除视频任务
| 参数 | 类型 | 说明 |
|---|---|---|
task_id必填 | string | 路径参数,使用创建任务后返回的 task_id。 |
核心功能
- 文生视频
描述人物动作、镜头移动和画面节奏,从提示词生成片段。
- 支持
- 图生视频
从图片出发制作运动画面,在提示词里说明主体或镜头如何移动。
使用首帧,或首帧与尾帧引导生成
- 支持
- 首帧
提供起始画面,从确定的主体位置、视角和光线开始生成。
- 支持
- 尾帧
提供目标结尾画面,引导镜头过渡到指定姿态或构图。
与首帧一起使用
- 支持
- 普通参考图
用图片约束角色、服装或场景外观,让新片段围绕参考内容生成。
最多 8 张参考图
- 支持
- 视频输入
把视频作为参考或源素材,通过请求声明片段的用途。
最多 5 段视频。单段 3–30 秒,合计不超过 30 秒
- 支持
- 视频编辑
用提示词说明要改动的主体、环境或画面风格,对源视频做新版本。
使用一段源视频,可搭配参考图片
- 支持
- 视频续写
从输入片段末尾继续生成,适合试做后续动作或镜头。
使用一段源视频续写,可指定目标尾帧
- 支持
- 生成音轨
把同步音轨随视频一起交付,可用于试听对白、声音和画面的配合效果。
视频始终包含立体声音轨
- 支持
模型亮点
续写视频时指定目标尾帧
上传一段源视频,可用目标尾帧引导续写后的收尾画面。支持最高 1080p 和 30 秒的输出,生成视频包含立体声音轨。
规格与限制
- 输出规格
- 720p / 1080p
- 时长
- 3–30 秒
- 画面比例
- 16:9 / 9:16 / 1:1 / 21:9
- 图片数量上限
- 最多 8 张
使用场景
首尾帧转场
给定转场起点和终点,让运动过程把两张确定的画面接起来。
已有片段改版
提供一个素材片段,说明需要更换的环境、对象或视觉风格,生成修改版本。
接续镜头动作
从源视频的结尾延续动作,为原片补一个收尾或后续运动。
有声分镜预演
让短片带上音轨,先试听画面和声音的配合,再决定后期录制或剪辑方案。
广告分镜试拍
用提示词写出产品出场、镜头接近和收尾定格,先看转场与节奏是否合适。
片头动效草稿
描述背景运动、主体入场和标题留白,生成短片作为剪辑片头的备选。
相关文章
常见问题
第一次生成,用什么输入最容易跑通?
从一句话、一个主体、一个动作开始。比如写清人物推门进入,镜头从门外缓慢推进,然后选模型支持的较短时长。
打开本页 Playground图片应该作为首帧还是参考素材?
首帧是视频的起始画面。先裁好图片、确认主体的位置,再描述后续动作。普通参考图用于提供角色或场景外观。提示词还要说明主体如何移动、镜头如何拍摄。最多 8 张参考图。
查看调用参数编辑原片和续写镜头,怎么选?
需要重新生成原片中某些画面,用编辑。希望原片结尾之后继续发生动作,用续写。使用一段源视频,可搭配参考图片。使用一段源视频续写,可指定目标尾帧。
查看调用参数生成的视频会带声音吗?
视频始终包含立体声音轨。准备后期配旁白时,先试听生成音轨,再在剪辑软件里调整或替换。
查看调用参数第一次试片,分辨率和时长怎么选?
可先从 720p、3 秒试起,重点看动作和构图。最终导出时再按所选模式确认可用的分辨率、时长和素材组合。
查看调用参数创建成功了,为什么还没有视频?
创建成功表示任务已接受。用本次返回的 status_url 查询状态,排队或生成时继续等。成功后使用 content_url 下载片段。
查看接入方式查询任务返回 404,要重新生成吗?
先保留原任务 ID,核对 status_url 和本次生成使用的账号,再看用量明细。查询失败本身不能判断任务结果,重复提交会创建新的任务。
生成中余额已经变少,最终费用怎么看?
视频任务创建时会预占费用。完成后查看任务返回的 cost_rmb 或用量明细。明确失败的任务会退回预占金额。
查看本站计费为什么换了分辨率、时长或声音设置就报 400?
同一型号的候选规格有时随输入模式改变。先确认横屏或竖屏、是否传了素材,再按调用参数选合法组合。已有报错时优先按错误字段修正。
查看调用参数


