Kling V4

使用 kling-v4 调用文生视频、图生视频、参考生视频、视频编辑和视频续写。支持 720p / 1080p，每个新增片段 3–30 秒，始终包含立体声音轨。

Base URL： https://apimaster.ai/v1。当前接口所有生成模式都应提供非空 prompt。无提示词图生经实测会被拒绝；请描述期望的运动或运镜。每次请求都使用 Authorization: Bearer YOUR_API_KEY。素材链接必须公开可下载，无需登录、Cookie 或防盗链鉴权。

提交、查询与下载

向 POST https://apimaster.ai/v1/videos/generations 发送 JSON，设置 Content-Type: application/json。

curl "https://apimaster.ai/v1/videos/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"kling-v4","prompt":"一只纸船在平静池塘上缓缓漂流，水波轻荡，伴随轻柔水声。","duration":3,"resolution":"720p","aspect_ratio":"16:9"}'

{"id":"task_example","task_id":"task_example","object":"video","model":"kling-v4","status":"queued","created_at":1792756800}

拿到任务 ID 仅代表请求已接收。每隔 10–20 秒调用 GET https://apimaster.ai/v1/videos/{task_id}，直到 status 为 completed 或 failed。中间状态包括 queued、in_progress。成功后返回需鉴权的 APIMaster 视频地址；请使用同一 API key 尽快下载：

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o kling-v4.mp4

失败时查看 error.code、error.message，修正请求后重新提交。成功生成的视频也可在控制台用量日志中预览和下载。

完整请求参数

参数	类型	必填 / 默认值	说明
model	string	必填	固定 kling-v4。
prompt	string	必填（含图生视频）	描述画面、动作、运镜及声音。参考模式可用 @Image1、@Video1、@Audio1，按各类素材数组顺序从 1 编号；编辑模式输入视频为 @Video1。
duration	integer	默认 5	生成时长 3–30 秒。编辑不传时跟随输入视频时长，向上取整且最多 30 秒；续写表示新增片段时长。
resolution	string	720p	支持 720p、1080p，不使用 mode。
aspect_ratio	string	随模式变化	16:9、9:16、1:1、21:9；参考模式额外支持 auto。文生默认 16:9，图生与编辑跟随输入，参考默认 auto；续写禁止传入。
image_urls	string[]	可选	图生：第 1 张首帧、第 2 张尾帧，最多 2 张。参考或编辑：最多 10 张参考图。仅用参考图生成时显式传 omni_reference_task_type: "reference"。
image_with_roles	object[]	可选	图片角色数组，每项包含 url 和 role。图生模式勿将 image_urls 与显式首尾帧字段混用。
image_with_roles[].url	string	每项必填	公开 HTTP(S) 图片地址。
image_with_roles[].role	string	每项必填	first_frame、last_frame、keyframe（也接受 middle_frame）、reference_image。
first_frame_image	string	可选	首帧地址，也可通过 image_urls 第 1 张或 first_frame 角色提供。
last_frame_image	string	可选	图生尾帧或续写的目标尾帧地址。
video_urls	string[]	可选	参考模式最多 5 段视频、总输入时长最多使用 30 秒；编辑或续写可用恰好 1 条代替 video_url，必须显式指定任务类型。
video_url	string	编辑 / 续写必填，或用 video_urls	输入视频，必须同时指定 edit 或 extend，勿与 video_urls 同传。编辑视频至少 3 秒，超过 30 秒取前 30 秒。
audio_urls	string[]	仅参考模式可选	最多 3 段参考音频，每段 5–30 秒。
omni_reference_task_type	string	auto	auto、reference、edit、extend；auto 按素材自动选择文生、图生或参考模式。
audio_setting	string	随模式变化	origin 保留原声，auto 重新配声。仅支持编辑或带参考视频的参考模式；编辑默认保留原声，参考默认重新配声；续写禁止传入。

图生模式必须恰好 1 张首帧，最多 1 张尾帧、8 张中间帧、10 张总图，中间帧按数组顺序使用。参考模式最多 10 张图片、5 段视频、3 段音频，合计 15 个素材。参考模式使用 reference_image 角色；编辑参考图使用 image_urls。续写除输入视频外只接受可选目标尾帧。

兼容别名：seconds 对应 duration，size 对应分辨率（720p / 1080p），ratio 对应 aspect_ratio。别名与标准字段冲突时返回 HTTP 400。建议直接使用表中的标准字段。

各模式示例

图生视频：

{"model":"kling-v4","prompt":"Slow camera movement, gentle motion.","image_urls":["https://example.com/start.png","https://example.com/end.png"],"duration":5}

首帧、中间帧、尾帧：

{"model":"kling-v4","prompt":"Animate smoothly through the supplied frames.","image_with_roles":[{"url":"https://example.com/start.png","role":"first_frame"},{"url":"https://example.com/middle.png","role":"keyframe"},{"url":"https://example.com/end.png","role":"last_frame"}],"duration":10}

参考生视频：

{"model":"kling-v4","prompt":"让 @Image1 中的角色跟随 @Video1 的运镜，背景音乐参考 @Audio1。","image_with_roles":[{"url":"https://example.com/character.png","role":"reference_image"}],"video_urls":["https://example.com/camera.mp4"],"audio_urls":["https://example.com/music.mp3"],"omni_reference_task_type":"reference","aspect_ratio":"auto","duration":5}

视频编辑，不传时长和比例时跟随输入视频：

{"model":"kling-v4","prompt":"将画面改为下雪的冬夜。","omni_reference_task_type":"edit","video_url":"https://example.com/input.mp4","image_urls":["https://example.com/style.png"],"audio_setting":"origin"}

视频续写，返回原视频与新增片段拼接的完整视频：

{"model":"kling-v4","prompt":"镜头继续向前推进，天色渐暗。","omni_reference_task_type":"extend","video_url":"https://example.com/input.mp4","duration":5,"last_frame_image":"https://example.com/target.png"}

示例素材地址是占位符，请替换为实际可公开访问的图片、视频或音频。

计费与退款

官方基础价（核查于 2026-10-23）

Kling 开发者定价页切换到 Balance 后列出以下预览价，作为模型基础参考价；实际渠道与账户价格以模型卡为准。官方页面将其直连接口标为 Coming Soon，APIMaster 的可用状态以自身模型卡为准。

档位	基础价 USD / 计费秒
720p，无视频输入	$0.157
1080p，无视频输入	$0.235
720p，有视频输入	$0.094
1080p，有视频输入	$0.141

按计费秒数收费，720p、1080p 分别定价。编辑与带参考视频的参考生成使用视频输入档单价。最新价格与可用路由见 Kling V4 模型卡，最终扣费还受渠道与账户系数影响，以用量日志为准。

模式	计费秒数
文生、图生、仅含图片或音频的参考生成	输出秒数
视频续写	新增片段秒数，不重复收取原视频时长
编辑、带参考视频的参考生成	输出秒数 + max(输出秒数, 输入视频秒数)

输入视频时长先求和，再向上取整，最多计 30 秒。例如编辑 3.04 秒的视频且不传 duration，输出为 4 秒，按视频输入档计 8 秒。给 20 秒视频续写 5 秒，即使返回文件为 25 秒，也只按新增的 5 秒计费。

编辑与参考视频模式在提交前由服务器测量输入视频；探测失败会在生成扣费前拒绝请求。生成任务失败退回预扣的生成费用；无效参数不收费。反复查询已完成任务不会重复收取生成费。

不支持的参数与排错

V4 始终包含立体声。不要传 mode、negative_prompt、multi_shot、multi_prompt、element_list、video_list、camera_control、voice_list 及其他未列出的字段。audio: false、watermark: true 不支持；audio: true、watermark: false 作为兼容值接受。audio_setting 仅在支持的模式下使用。

错误	处理方法
HTTP 400 / 参数无效	检查 JSON 类型、素材数量、任务模式和字段组合；duration 必须是 JSON 整数。
无法测量输入视频时长	换成可公开下载、无鉴权和防盗链限制的有效 MP4 / MOV 地址。
传 video_url 但未指定编辑或续写	参考模式改用 video_urls；单数 video_url 必须指定 edit / extend。
HTTP 503 / 价格不可用	当前档位不可用，请查看模型卡。
异步生成失败	查看任务错误，检查素材后修正重试；生成预扣费用退回。

注册账户后创建 API Key，使用 https://apimaster.ai/v1 与模型 ID kling-v4 调用。