guides

Kling 4.0 Flash API 指南:参数、价格与代码示例

Poyo.ai Team
7 min read
Share:

核心要点

  • Kling 4.0 Flash 是 Kling 4.0 中速度更快、价格更低的档位。 它能用文字、一张首帧图片或参考素材生成 3–20 秒的 720p 视频,也能编辑已有视频。
  • 一个模型 ID 覆盖所有模式。 向 POST /api/generate/submit 发送 "model": "kling-4.0-flash",请求里带了哪些素材,就决定走文生视频、图生视频、参考生视频还是视频编辑。
  • 在 PoYo 上每输出秒 $0.094(18.8 积分,适用于文字、图片和图片参考任务),5 秒视频 $0.47,10 秒视频 $0.94。有视频输入时,单价为每计费秒 $0.063。
  • 一个 Key,按量付费。 PoYo 用按量付费的积分给 Flash 计费,无需订阅;同一个 Key、同一种请求格式还能调用 Kling 4.0、Gemini Omni 和 Veo。
  • 结果异步返回。 保存好 task_id,然后轮询 GET /api/generate/status/{task_id},或者设置 callback_url。
  • 切换到 Kling 4.0 只需改一个词。 两款模型的请求字段相同;Kling 4.0 另外支持 1080p、30 秒视频、尾帧和多镜头提示词。

Kling 4.0 Flash 一览

PoYo 上的 Kling 4.0 Flash
开发方快手(可灵 AI)
API 模型 IDkling-4.0-flash
模型页/zh/models/kling-4-0-flash
模式文生视频、图生视频(一张首帧)、参考生视频、视频编辑
视频时长3–20 秒,整数秒;默认 5 秒
分辨率720p(按可灵的说明为 8-bit SDR)
画幅16:9(默认)、9:16、1:1、21:9、auto
参考素材最多 10 张图片、5 段视频、7 个主体,合计 15 项
输入视频总时长源视频、参考视频和视频主体合计最长 20 秒
提示词长度最多 26,000 个字符
价格$0.094/秒 · 有视频输入时 $0.063/计费秒

Kling 4.0 Flash 是什么?

Kling 4.0 Flash 是快手可灵 Kling 4.0 视频家族中主打速度的成员。可灵官方指南称它为高频创作而设计,兼顾"快速生成与出色的性价比",并列出 3–20 秒、720p,支持文生视频、图生视频和全能参考(Omni Reference)。在 PoYo 上,完整版 Kling 4.0 最长 30 秒、最高 1080p,并增加了首尾帧和多镜头提示词。

"Kling 4 Flash" 和 "Kling 4.0 Flash" 指的是同一个模型。在 PoYo 上,页面路径是 kling-4-0-flash,API 模型 ID 是带点的 kling-4.0-flash。

当出片数量和速度比最高分辨率更重要时,就适合用 Flash:社交短视频、开头和版式测试、产品循环展示、预演,以及正式渲染前的多轮草稿。

Kling 4.0 Flash 生成的 720p 视频:两名武者在阳光照进的木质道场里对练。示例来自 PoYo 模型页。

一个模型 ID,四种模式

PoYo 根据 input 里的字段选择模式:

模式需要传说明
文生视频prompt可选 aspect_ratio
图生视频image_urls 放一张图prompt 可选;画幅由首帧图片决定
参考生视频reference_image_urls、reference_video_urls 和/或 kling_elements可在 image_urls 里附一张首帧,计入 10 张图片的上限
视频编辑video_url + prompt可加参考图、最多 4 段参考视频和主体;画幅沿用源视频

优先级是固定的:有 video_url 就是编辑;有任一参考字段就是参考生视频;只有 image_urls 就是图生视频;只有提示词就是文生视频。

请求参数

model 和 callback_url 放在顶层,其余字段都放在 input 里。

字段类型取值和限制默认值
modelstringkling-4.0-flash必填
callback_urlstring公网可访问的 URL,任务完成或失败时会收到一次 POST—
promptstring1–26,000 个字符;文生、参考和编辑模式必填,图生视频可选—
durationinteger3–205;编辑时为源视频时长
resolutionstring720p720p
aspect_ratiostringauto、16:9、9:16、1:1、21:9(文生和参考模式)16:9
image_urlsarray一张首帧图片—
reference_image_urlsarray最多 10 张图片—
reference_video_urlsarray最多 5 段视频(编辑时 4 段),每段 3–20 秒—
kling_elementsarray最多 7 个主体;每个主体二选一:element_input_urls(2–4 张图,正面图放第一张)或 element_input_video_urls(一段 3–8 秒视频);视频主体最多 3 个—
video_urlstring要编辑的源视频,3–20 秒—

提交前要检查的通用限制:

  • 合计最多 15 项: 首帧 + 参考图 + 参考视频 + 主体。
  • 输入视频合计最长 20 秒: 源视频 + 参考视频 + 视频主体。
  • 标签按数组顺序编号: @Image1、@Video1、@Element1。编辑时源视频是 @Video1,参考视频从 @Video2 开始。
  • Playground 上传格式: MP4 或 MOV,每段视频最大 200 MB。素材 URL 必须是公网可访问的 HTTP 或 HTTPS 链接。

提交第一个请求

先在 PoYo 控制台创建 API Key,并只保存在服务端。然后提交一个 5 秒的文生视频任务:

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-4.0-flash",
    "input": {
      "prompt": "木质窗台上一杯陶瓷马克杯里的咖啡冒着热气,雨水顺着玻璃流下。镜头缓慢推近,柔和的晨光,画面干净、无文字和标志。",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

提交成功会返回 code: 200,任务信息在 data 里:

{
  "code": 200,
  "data": {
    "task_id": "YOUR_TASK_ID",
    "status": "not_started",
    "created_time": "2026-11-14T10:30:00"
  }
}

参数校验错误也可能以 HTTP 200 加 code: 400 的形式返回,所以 HTTP 状态码和 code 字段都要检查。402 表示账户积分不足。

更多请求示例

用一张首帧做图生视频

{
  "model": "kling-4.0-flash",
  "input": {
    "image_urls": ["https://example.com/red-panda.png"],
    "prompt": "小熊猫抖掉身上的雪,然后转头看向镜头。镜头缓慢推近,浅景深。",
    "duration": 5
  }
}

图生视频结果:落满雪的竹枝上,小熊猫抖掉身上的雪,转头看向镜头。时长 5 秒,消耗 94 积分。示例来自 PoYo 模型页。

带主体的参考生视频

下面的主体用了一张正面图和一张侧面图。提示词用 @Element1 指代这个主体,用 @Image1 指代地点图片:

{
  "model": "kling-4.0-flash",
  "input": {
    "prompt": "黄金时刻,@Element1 沿着悬崖顶上的小路走向 @Image1 中的灯塔。镜头在他身侧跟拍,他停下脚步,抬头看向灯塔的灯。保持他的面容和黄色雨衣与 @Element1 一致。",
    "reference_image_urls": ["https://example.com/lighthouse.png"],
    "kling_elements": [
      {
        "element_input_urls": [
          "https://example.com/keeper-front.png",
          "https://example.com/keeper-side.png"
        ]
      }
    ],
    "duration": 8,
    "aspect_ratio": "9:16"
  }
}

参考生视频结果:黄金时刻,身穿黄色雨衣、头戴红色毛线帽的灯塔看守人沿悬崖小路走向灯塔,由一张地点图和一个双视角主体生成。时长 8 秒,9:16,消耗 150.4 积分。示例来自 PoYo 模型页。

编辑已有视频

输出默认沿用源视频的时长:

{
  "model": "kling-4.0-flash",
  "input": {
    "video_url": "https://example.com/winter-clip.mp4",
    "reference_image_urls": ["https://example.com/spring-bamboo.png"],
    "prompt": "Edit @Video1,把季节从冬天改成春天,以 @Image1 作为环境参考。动物本身、它的动作、节奏和运镜都与 @Video1 完全一致。"
  }
}

编辑结果:把上面那段雪中小熊猫的视频改成春天,换上翠绿的竹林和樱花,小熊猫的动作和运镜保持不变。消耗 151.2 积分。示例来自 PoYo 模型页。

轮询任务状态

随时可以用任务 ID 查询:

curl https://api.poyo.ai/api/generate/status/YOUR_TASK_ID \
  -H "Authorization: Bearer $POYO_API_KEY"

状态从 not_started 变为 running,最后是 finished 或 failed。完成的任务会在 data.files 中给出视频,包含 file_url 和 file_type: "video";失败的任务会带 error_message。

下面是一个有超时上限、适合放在后端的 Python 循环:

import os
import time
import requests

API = "https://api.poyo.ai"
HEADERS = {"Authorization": "Bearer " + os.environ["POYO_API_KEY"]}

def data_or_raise(resp):
    resp.raise_for_status()
    body = resp.json()
    if body.get("code") not in (0, 200):
        raise RuntimeError(body.get("message") or body)
    return body["data"]

task = data_or_raise(requests.post(f"{API}/api/generate/submit", headers=HEADERS, json={
    "model": "kling-4.0-flash",
    "input": {
        "prompt": "一盏纸灯笼从夜市上空缓缓升起。镜头慢慢上摇,暖色灯光,下方摊位灯火通明。",
        "duration": 5,
        "aspect_ratio": "9:16",
    },
}, timeout=60))
task_id = task["task_id"]
print("task:", task_id)

deadline = time.monotonic() + 20 * 60
while time.monotonic() < deadline:
    status = data_or_raise(requests.get(f"{API}/api/generate/status/{task_id}", headers=HEADERS, timeout=60))
    if status["status"] == "finished":
        print([f["file_url"] for f in status.get("files", []) if f.get("file_type") == "video"])
        break
    if status["status"] == "failed":
        raise RuntimeError(status.get("error_message") or "generation failed")
    time.sleep(10)
else:
    print("Still running; check this task_id again later:", task_id)

如果循环超时,稍后用同一个 task_id 再查即可;每次新提交都是一条单独计费的视频。生产环境里,在顶层设置 callback_url,就能用 Webhook 取代轮询。

Kling 4.0 Flash 单条成本

PoYo 用按量付费的积分按秒给 Flash 计费($1 = 200 积分)。文字、图片和图片参考任务按输出时长统一计价,参考图和图片主体都包含在内。

输出时长积分美元
3 秒56.4$0.282
5 秒94$0.47
8 秒150.4$0.752
10 秒188$0.94
15 秒282$1.41
20 秒376$1.88

作为对比,同样 5 秒的视频在 Kling 4.0 上(720p)是 $0.7125,Flash 便宜约 34%。

有视频输入时

请求中只要包含源视频、参考视频或视频主体,单价就是每计费秒 12.6 积分($0.063),其中:

计费秒数 = 输出时长 + max(输入视频总时长向上取整,输出时长)

任务计费秒数积分美元
用一段 4 秒参考视频生成 5 秒视频5 + max(4, 5) = 10126$0.63
用合计 12 秒的参考视频生成 10 秒视频10 + max(12, 10) = 22277.2$1.386
编辑一段 8 秒视频,保持原时长8 + max(8, 8) = 16201.6$1.008
编辑一段 15 秒视频,加一段 5 秒参考视频15 + max(20, 15) = 35441$2.205

不足一秒的输入时长会向上取整。模型页上那个"冬变春"的编辑示例,源视频略长于 5 秒,按 6 秒计算:6 + 6 = 12 个计费秒,即 151.2 积分。如果要给整个 Kling 4.0 家族做预算,可以看我们的 Kling 4.0 API 价格指南。

Kling 4.0 Flash 提示词技巧

  1. 每条视频写一个连续动作。 短视频里,提示词跟着一个主体完成一个动作时最稳定,比如"转身、停顿、抬头"。多段情节留给 10–20 秒的视频,按"铺垫、动作、收尾"来写。
  2. 写明运镜。 推镜、环绕、跟拍、上摇。单独用一句话写,让它在画面细节中更醒目。
  3. 描述光线和质感。 写清时间段、光线方向和材质,比如湿玻璃、拉丝金属或毛发,720p 视频的画面会更清晰、统一。
  4. 给每个输入打标签。 按数组顺序用 @Image1、@Video1、@Element1 指代素材,并说明每个素材负责什么:身份、地点、动作还是风格。
  5. 认真准备主体。 正面图放第一张,再加 1–3 个其他角度,背景尽量干净。视频主体用一段清晰的 3–8 秒视频。
  6. 编辑时以 "Edit @Video1" 开头。 接着写要改什么,再列出需要保持不变的内容:身份、动作、节奏和运镜路径。
  7. 要求画面干净。 如果之后要自己加字幕或品牌元素,加上"画面干净、无文字和标志"。
  8. 时长与创意匹配。 5 秒适合一个动作或一次揭晓。15–20 秒留给需要更多空间的动作,因为费用随秒数增加。

Kling 4.0 Flash 的运镜控制:镜头环绕一辆在霓虹灯下、烟雾中漂移的赛车,最后停在车头正面。示例来自 PoYo 模型页。

更多适用于整个家族的提示词写法,见 Kling 4.0 提示词指南和全能参考指南。

Kling 4.0 Flash 与 Kling 4.0 简要对比

Kling 4.0 FlashKling 4.0
模型 IDkling-4.0-flashkling-4.0
分辨率720p720p、1080p
视频时长3–20 秒3–30 秒
帧控制一张首帧首帧和尾帧
多镜头提示词每条视频一个提示词multi_prompt,可分别设置每个镜头的时长
编辑时的参考素材图片、最多 4 段参考视频和主体图片和图片主体
720p 文字和图片任务价格$0.094/秒$0.1425/秒

先用 Flash 打草稿,确定方向后,如果成片需要 1080p、尾帧或超过 20 秒,再换到 Kling 4.0。完整对比见 Kling 4.0 与 Flash 的区别。想了解 Flash 和 Google 快速视频模型的对比,可以看 Gemini Omni 1.2 Flash vs Kling 4.0 Flash vs Veo 3.1。

常见问题

Kling 4.0 Flash 的模型 ID 是什么?

kling-4.0-flash。kling-4-0-flash 用于页面路径。请求体里要写 "model": "kling-4.0-flash"。

Kling 4.0 Flash 多少钱?

在 PoYo 上,文字、图片和图片参考任务每输出秒 18.8 积分($0.094):5 秒 $0.47,10 秒 $0.94,20 秒 $1.88。有视频输入时,每计费秒 12.6 积分($0.063)。

Kling 4 Flash 免费吗?

在 PoYo 上,Kling 4.0 Flash 使用按量付费的积分,无需订阅。每次生成都从积分余额中扣除;Playground 会在生成前显示积分预估,你可以先确认某个提示词、参考组合或编辑任务要花多少。

Kling 4.0 Flash 的视频最长多久?

每次生成 3 到 20 秒,按整数秒设置。默认 5 秒;编辑时如果不设置 duration,就保持源视频时长。

什么时候该从 Flash 换到 Kling 4.0?

Flash 专为用提示词、首帧或参考素材生成 720p 视频而设计。如果需要 1080p、尾帧、multi_prompt 或最长 30 秒的视频,请用 Kling 4.0,请求字段完全相同。

Kling 4.0 Flash 比 Kling 4.0 快吗?

可灵把 Flash 定位为速度更快的档位,专为高频创作和快速迭代设计。生成时间和视频时长、当前负载有关,建议用你自己的几个提示词测一测。

同一个 Key 能调用其他视频模型吗?

可以。调用 Kling 4.0 Flash 的 PoYo Key 也能调用 Kling 4.0、Gemini Omni 1.2 Flash、Veo 3.1 等模型,使用同一套提交和状态接口,共用一份积分余额。

视频生成好后能通过 Webhook 通知吗?

可以。在顶层加上 callback_url,任务完成或失败时 PoYo 会向它发送一次 POST。你也随时可以用同一个 task_id 查询状态接口。

Share: