Kling V4 Flash

kling-v4-flash 的 APIMaster 网关契约，核查日期 2026-11-07。渠道 317 支持文生、单首帧图生、图片与视频参考、编辑和续写；输出统一为 720p、24fps、3–20 秒，与普通 Kling V4 是不同模型。

Kling V4 Flash

接口与认证

• POST https://apimaster.ai/v1/videos
• POST https://apimaster.ai/v1/videos/generations
• GET https://apimaster.ai/v1/videos/{task_id}
• GET https://apimaster.ai/v1/videos/{task_id}/content
• GET https://apimaster.ai/v1/video-submissions/by-key

字段与限制

使用 JSON 和 Authorization: Bearer YOUR_API_KEY。model 固定 kling-v4-flash。除单首帧图生外，prompt 均必填。duration 与 seconds 仅接受 3–20 的 JSON 整数，默认 5；null 视为省略，显式 0 拒绝。两个别名同时出现时必须都有效且相等。编辑省略时长时，使用输入视频流时长向上取整。resolution 仅支持 720p。aspect_ratio（兼容别名 size）支持 16:9、9:16、1:1、21:9；仅参考模式支持 auto。文生默认 16:9，参考默认 auto，编辑省略比例则跟随输入。图生及续写拒绝非空 aspect_ratio/size，需要其他比例请先裁剪首帧。audio 仅允许 true，watermark 仅允许 false。

参数	JSON 类型	是否必填	默认值	用途、取值与限制
model	string	必填	kling-v4-flash	固定传 kling-v4-flash。五种操作共用此模型 ID；kling-v4 是另一个模型，不能混用。
prompt	string	按模式	—	描述画面、动作或修改目标。文生、参考、编辑、续写必填；仅单首帧图生可以省略。用 @Image1、@Video1 等引用素材，图片与视频各自按数组顺序从 1 编号；编辑源视频为 @Video1。
duration	integer / null	可选	5	输出时长，使用 3–20 的 JSON 整数，通常默认 5 秒。编辑省略两个时长字段时，跟随输入视频流时长并向上取整；续写表示新增片段时长。null 视为省略，0、非整数数值及字符串数字均拒绝；实际文件多约一帧时仍按该整数计费。
seconds	integer / null	可选	—	duration 的兼容别名，范围和省略规则相同。建议只传一个；两个都传时必须各自有效且相等，否则返回 400。
resolution	string	可选	720p	输出清晰度档位，仅支持 720p。不代表输出短边始终为 720 像素；不支持 1080p，也不能通过 mode 切换画质。
aspect_ratio	string	可选	按模式	文生、参考、编辑可用 16:9、9:16、1:1、21:9；仅参考还支持 auto。文生默认 16:9、参考默认 auto、编辑默认跟随源视频。图生与续写不接受非空值；空字符串视为省略。
size	string	可选	—	aspect_ratio 的兼容别名，表示宽高比，不是清晰度或 1280x720 像素尺寸。两个字段都传时必须相同；单首帧图生及续写应同时省略这两个字段。
image_urls	string[]	按模式	—	公开图片 URL 数组。自动模式只接受一张首帧；仅用图片做参考时须明确设置 reference。参考/编辑最多 10 张，与 reference_image 角色图片合并计数。图生不能与其他首帧字段混用；续写不接受图片。
first_frame_image	string	按模式	—	单张首帧的公开图片 URL。与单个 image_urls 或单个 first_frame 角色条目是三选一关系，不能重复提供首帧。用于图生，此时提示词可省略。图片宽、高均至少 300px，宽高比 2:5–5:2；需要其他构图时先裁图。
image_with_roles	{url, role}[]	按模式	—	对象数组，每项必含 url（公开 HTTP(S) 图片 URL）和 role。first_frame 用于唯一首帧；reference_image 用于参考/编辑。尾帧、中间帧、关键帧均不支持。两种图片字段合计最多 10 张参考图，参考图与参考视频总计最多 15 个素材。
video_url	string	按模式	—	单条源视频公开 URL，仅用于明确指定的 edit / extend，与 video_urls 互斥。编辑输入须为 MP4/MOV、视频流时长 3–20 秒，宽和高分别为 700–4553px。续写从源视频最后一帧生成，只返回新增片段；此处不能填任务 ID 或会话 ID。
video_urls	string[]	按模式	—	参考视频 URL 数组，最多 5 条；每条 MP4/MOV、视频流时长至少 3 秒，宽和高分别为 700–4553px，总时长不超过 20 秒。明确设置编辑/续写时也可传恰好 1 条代替 video_url。超长直接拒绝，不自动截取；参考模式可由此字段自动识别。
omni_reference_task_type	string	可选	auto	auto 根据素材识别文生、首帧图生或参考；reference 将图片视为参考图且要求有参考素材；edit / extend 要求恰好一条源视频。仅传 video_url 而未明确编辑/续写无效；自动模式下两张普通图片不会自动变成参考模式。
audio_setting	string	可选	auto	仅用于含参考视频的参考模式。auto 重新生成声音；origin 保留第一条参考视频原声，若其没有音轨，输出也没有音轨。编辑重新生成声音，应省略此字段；文生、仅图片参考及续写也不支持。它不是音频 URL 参数。
audio	boolean	可选	true	兼容布尔参数，只能省略或传 true；false 拒绝。它不控制是否保留原声，应在支持的模式下使用 audio_setting。不支持单独上传音频作为参考。
watermark	boolean	可选	false	兼容布尔参数，只能省略或传 false；true 拒绝。此参数不提供对输入素材去水印的服务。

使用不含嵌入认证信息的公开 HTTP(S) 直链，不支持 base64、本地路径或任务 ID。上游此页未另行承诺图片文件格式及字节上限。网关每条被探测的参考/编辑视频最多读取 100MiB，这不是对所有上游上传素材的统一大小承诺。

模式与素材

生成模式	选择方式与必需素材	默认行为与不支持项
文生视频	不传图片/视频，提示词必填；任务类型省略或为 auto。	默认 5 秒、16:9；不支持参考音频或 audio_setting。
单首帧图生视频	通过三种首帧字段之一提供恰好一张图片，提示词可省略。	默认 5 秒，跟随图片比例；省略 aspect_ratio / size，不支持尾帧。
参考生视频	reference + 图片，或使用 reference_image 角色、video_urls；提示词必填。	默认 5 秒、auto；图片≤10、视频≤5、合计≤15；带视频才能用 audio_setting。
视频编辑	明确 edit + 恰好一条源视频，提示词必填；可附最多 10 张参考图。	时长默认随输入向上取整，比例默认随输入；不接受帧角色或 audio_setting。
视频续写	明确 extend + 恰好一条源视频，提示词必填。	默认新增 5 秒，比例随输入；不接受图片、比例覆盖或 audio_setting；不沿用编辑/参考的最小尺寸及最小时长检查。

omni_reference_task_type 支持 auto、reference、edit、extend。单张 image_urls、first_frame_image 或恰好一个 first_frame 角色用于图生；多张参考图需要明确 reference 或 reference_image 角色，auto 下直接给两张 image_urls 会拒绝。video_urls 默认用于参考，edit/extend 时可提供一条。video_url 必须明确 edit/extend，且与 video_urls 互斥。编辑及续写需要一条视频；编辑可附参考图，续写不接受图片或 audio_setting，且只返回新增片段。续写输入应为公开可访问的源视频 URL，本接口不接受平台任务 ID 或上游会话 ID 作为续作参数。

素材使用不含认证信息的公开 HTTP(S) 直链。参考图/编辑图最多 10 张，图片加参考视频合计最多 15 个；图片宽高均至少 300 像素，宽高比 2:5–5:2。参考视频最多 5 条 MP4/MOV，每条至少 3 秒，合计不超过 20 秒；编辑仅一条 3–20 秒视频，宽和高分别须在 700–4553 像素之间。网关单条探测最多读取 100 MiB，按视频流时长计量，不按容器或音轨。续写输入不受上述编辑/参考尺寸与最小时长检查限制。上游还会检查素材几何尺寸，拒绝受理的请求无最终生成费用。audio_setting=origin 仅适用于带视频的参考模式，保留首条参考视频声音，无音轨则输出静音；auto 重新生成声音。编辑重新生成声音，不支持该字段。音频 URL、尾帧/中间帧、关键帧、negative_prompt、mode、seed、多镜头及主体/音色列表均不支持。

输出像素与帧率

比例 / 模式	上游公布的输出像素	帧率
16:9	1280×720	24 fps
9:16	720×1280	24 fps
1:1	960×960	24 fps
21:9	1464×628	24 fps
单首帧图生视频	跟随首帧比例，总像素约 0.92MP，例如 2:5 首帧约为 604×1516。	24 fps

这里是输出规格，不是输入素材的尺寸要求。例如 21:9 成片高度为 628px，不能直接满足参考/编辑输入至少 700px 的门槛；再次用于这些模式时需准备合规源素材，续写则不受该最小尺寸检查限制。实际时长可能比请求整数多约一帧。

不执行生成的示例

1. text

{
  "model": "kling-v4-flash",
  "prompt": "A paper boat floats along a quiet stream.",
  "duration": 3,
  "aspect_ratio": "16:9"
}

2. first_frame

{
  "model": "kling-v4-flash",
  "image_urls": [
    "https://example.com/start.png"
  ],
  "duration": 3
}

3. reference_image

{
  "model": "kling-v4-flash",
  "prompt": "Animate the scene from @Image1.",
  "omni_reference_task_type": "reference",
  "image_urls": [
    "https://example.com/style.png"
  ],
  "duration": 3
}

4. mixed_reference

{
  "model": "kling-v4-flash",
  "prompt": "Animate @Image1 with the camera movement from @Video1.",
  "omni_reference_task_type": "reference",
  "image_with_roles": [
    {
      "url": "https://example.com/subject.png",
      "role": "reference_image"
    }
  ],
  "video_urls": [
    "https://example.com/camera.mp4"
  ],
  "duration": 5,
  "aspect_ratio": "auto",
  "audio_setting": "origin"
}

5. reference_video

{
  "model": "kling-v4-flash",
  "prompt": "Follow the camera movement from @Video1.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "duration": 3,
  "aspect_ratio": "auto"
}

6. reference_video / origin

{
  "model": "kling-v4-flash",
  "prompt": "Follow @Video1 and preserve its original sound.",
  "video_urls": [
    "https://example.com/input.mp4"
  ],
  "audio_setting": "origin",
  "duration": 3
}

7. edit / duration

{
  "model": "kling-v4-flash",
  "prompt": "Change the light in @Video1 to sunset.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

8. edit / default

{
  "model": "kling-v4-flash",
  "prompt": "Change @Video1 to a snowy scene.",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/input.mp4",
  "image_with_roles": [
    {
      "url": "https://example.com/style.png",
      "role": "reference_image"
    }
  ]
}

9. extend

{
  "model": "kling-v4-flash",
  "prompt": "Continue the camera moving forward.",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/input.mp4",
  "duration": 3
}

计费规则

官方名义基础价为 720P 输出每秒 $0.094，720P-input 每计费秒 $0.0628。文生、图生、仅图片参考以及续写按输出/新增片段秒数计费。视频参考与编辑按 输出 + max(输入, 输出) 计费：先将全部输入视频流时长相加，再对输入总时长向上取整。例如输入 3.04 秒、输出 3 秒，按 3 + max(4,3) = 7 秒乘视频输入档单价，不是只收 3 秒。两条 3.04 秒输入合计 6.08，先取整为 7 再代入。成片可能多约一帧，输出仍按请求的整数秒计费。资源包折扣与名义基础价分开，实际售价还取决于账户/模型规则，以模型卡和最终消费记录为准。生成失败退还预扣，停止轮询不会取消任务；网络超时或受理不明不代表可以重新生成。

input_seconds = ceil(sum(input_video_stream_seconds))
billable_seconds = output_seconds + max(input_seconds, output_seconds)

轮询、错误与安全重试

首次成功提交返回 HTTP 200、公开 task_id 和 queued。通过 GET /v1/videos/{task_id} 查询 queued/in_progress/completed/failed，容忍暂时 unknown。完成后的 url 与 metadata.url 是需要 Bearer 的代理地址，也可用 GET /v1/videos/{task_id}/content 下载。任务失败提供 error.code=generation_failed 与脱敏原因，参数错误使用 HTTP 400。每次新操作携带独立 Idempotency-Key（8–128 个可见 ASCII 字符，无空格）；同账户、同键、同请求重放返回 HTTP 202，不重复生成或预扣，改正文返回 409。用原请求头调用 GET /v1/video-submissions/by-key 查回执；accepted 且 task_ready=true 时轮询 task_id，pending/submitting 或尚未就绪时继续等待；acceptance_unknown 时保存原键并联系支持，禁止自动换键重发。404 并不证明原请求未受理。此为网关幂等，不代表上游按键查单；键至少保留 30 天。最终客户费用请按 other.task_id 查消费日志，轮询响应不保证包含最终账单。本模型不支持 /v1/videos/quote。下方仅为不执行的 JSON 示例，请替换素材地址；新操作换新键，重试才保留同一键与正文。

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "queued",
  "created_at": 1794052800
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "completed",
  "progress": 100,
  "created_at": 1794052800,
  "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content",
  "metadata": {
    "url": "https://apimaster.ai/v1/videos/task_REDACTED_EXAMPLE/content"
  }
}

{
  "id": "task_REDACTED_EXAMPLE",
  "task_id": "task_REDACTED_EXAMPLE",
  "object": "video",
  "model": "kling-v4-flash",
  "status": "failed",
  "progress": 100,
  "created_at": 1794052800,
  "error": {
    "code": "generation_failed",
    "message": "Generation failed"
  }
}

APIMart · Kling V4 Flash · Kling AI