Video
Kling 4.0 Flash
用文本、参考图片、参考视频和可复用的角色或道具主体,生成 3–20 秒、720p、带声音的 Kling 4.0 Flash 视频。
Kling 4.0 Flash 是快手的 Kling 4.0 家族中的轻量模型。在 SeedRouter 上,它支持文生视频和参考生成:最多 10 张参考图片、5 段参考视频和 7 个主体(用 2–4 张图片或一段短视频构建的命名对象),均需在提示词中提及。每段视频 3–20 秒、720p、带声音。发送请求,保存返回的任务 ID,再从该任务读取生成完成的视频。媒体以 URL 形式传入。
模型 ID
| 模型 ID | 输入 | 分辨率 | 时长 |
|---|---|---|---|
kling-4-0-flash | 文本、参考图片、参考视频、主体 | 720p | 3–20 秒 |
当前价格请查看模型页面。
快速示例
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kling-4-0-flash",
"prompt": "A paper boat drifts down a rain-filled city gutter at dusk, the camera skimming the water beside it past glowing shop windows, raindrops ticking on the surface. No text, no logos.",
"duration": 5,
"aspect_ratio": "16:9"
}'端点
POST https://api.seedrouter.ai/v1/videos/generations| 请求头 | 值 |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
响应是一个任务({"id": "task_...", "status": "processing"}),不是生成完成的视频。轮询 GET /v1/tasks/{task_id} 获取结果。保持 API Key 在服务端代码中。
参数
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
model | 字符串 | 必填 | kling-4-0-flash |
prompt | 字符串 | 必填 | 最多 8,000 个字符。用 @image_1、@video_1 或 @<element name> 提及素材(见「提及素材」)。 |
duration | 整数 | 5 | 输出时长 3–20 秒。 |
resolution | 枚举 | 720p | 仅支持 720p 输出。 |
aspect_ratio | 枚举 | 按输入 | auto、16:9、9:16、1:1、21:9。省略时:提供任何参考素材则为 auto,否则为 16:9。 |
image_urls | URL 列表 | 无 | 参考图片,最多 10 张,按顺序用 @image_1、@image_2、… 提及。 |
video_urls | URL 列表 | 无 | 参考视频,最多 5 段,用 @video_1、@video_2、… 提及。按视频输入费率计费。 |
keep_original_sound | 布尔值 | false | 保留参考视频本身的音频。仅在有 video_urls 时生效;没有参考视频时,始终为生成的视频配上新声音。 |
elements | 对象列表 | 无 | 本次请求的主体,最多 7 个,用 @name 提及(见「主体」)。 |
每段视频都带声音,没有声音开关。没有首帧、中间帧或尾帧字段,也没有 negative_prompt、watermark 或独立的 voices 字段:请用 voice_url 为主体绑定声音。参数结构严格:未知字段会被拒绝,而不是忽略。不支持 callback_url;请改为轮询任务。
提及素材
发送的每种素材都是可选的;不发送素材时,请求就是纯文生视频。发送素材后,请在提示词中指明它们:
| 素材 | 提及方式 | 限制 |
|---|---|---|
image_urls | @image_1、@image_2、… | 10 张图片 |
video_urls | @video_1、@video_2、… | 5 段视频 |
elements | @name | 7 个主体,其中最多 3 个为视频主体 |
每个后接字母、数字、下划线或汉字的 @,都必须指向本次请求中的一个素材,否则请求会在扣费前被拒绝。名称按最长优先匹配,不区分大小写。以字母、数字或下划线结尾的名称,后面不能紧接另一个字母、数字或下划线:只提供一张图片时,@image_12 会被拒绝;请写成 @image_1 2 或 @image_1,。
参考视频与视频主体合计最多 5 个,图片、视频和主体合计最多 15 个。
{
"model": "kling-4-0-flash",
"prompt": "The dancer from @image_1 performs the routine of @video_1 on a rooftop at dusk",
"image_urls": ["https://example.com/dancer.png"],
"video_urls": ["https://example.com/routine.mp4"],
"keep_original_sound": false,
"duration": 8
}主体
主体是可在提示词中复用的命名对象,分为两种:
| 字段 | 图片主体 | 视频主体 |
|---|---|---|
name | 必填 | 必填 |
type | image(默认) | video |
image_urls | 2–4 个视角,首张为主视角 | 不接受 |
video_url | 不接受 | 一段 3–8 秒的单镜头角色视频,最短边至少 700 像素 |
tag | character、animal、prop、costume、scene、effect 或 others;省略时自动推断 | 仅 character |
description | 最多 100 个字符 | 最多 100 个字符 |
voice_url | 参考音频;仅限角色(tag 为 character 或未填写) | 参考音频;省略时使用视频本身的语音 |
名称由 1–20 个字母、数字、下划线或汉字组成,不区分大小写且不能重复。image_N、video_N、keyframe_N、object_N、audio_N、first_frame 和 last_frame 为保留名称。
{
"model": "kling-4-0-flash",
"prompt": "@Mira opens the shop door and greets the morning crowd",
"elements": [
{
"name": "Mira",
"image_urls": ["https://example.com/mira-front.png", "https://example.com/mira-side.png"],
"tag": "character",
"description": "baker in a flour-dusted apron"
}
],
"aspect_ratio": "9:16",
"duration": 6
}媒体输入
图片、视频和音频是公开的 HTTP(S) URL。不接受 base64 数据 URI:把文件上传到你自己的存储,再传它们的 URL。参考视频和视频主体的总时长必须为 2–20 秒;接受请求时会读取其时长,无法读取时长的视频会在扣费前被拒绝。
计费维度
查看模型价格部分获取当前费率。Kling 4.0 Flash 按 720p 视频秒数计费:
text, reference images, image elements: cost = duration × standard rate
reference videos or video elements: cost = (output + max(output, input)) × video-input rateinput 是参考视频和视频主体的总时长,向上取整到整秒。接受请求时会测量时长,所以预留金额就是最终扣费金额。例:用 7.2 秒参考视频引导生成 5 秒视频,按 5 + 8 = 13 秒计费;用 3 秒参考视频时,按 5 + 5 = 10 秒计费。失败的任务不收费。
输出格式
提交返回任务:
{"id": "task_...", "model": "kling-4-0-flash", "status": "processing", "created_at": 1789689600}获取任务
GET https://api.seedrouter.ai/v1/tasks/{task_id}每 10–20 秒轮询一次,直到 status 为 completed 或 failed。轮询时网络超时不意味着生成失败:保存任务 ID 并继续检查。不要为了检查进度而创建新任务。
完成的任务
{
"id": "task_...",
"model": "kling-4-0-flash",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689800,
"output": {
"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
}
}在我们的测试中,5 秒视频在提交后 91–103 秒返回,格式为 MP4(H.264)、分辨率为 1280 × 720,并带立体声 AAC 音轨;文件时长比 duration 约多一帧(设为 5 秒时,文件为 5.04 秒)。
错误
任务创建前被拒的请求返回 HTTP 错误和 error 对象,且不收费。任务接受后失败,查询时会返回 HTTP 200,并包含 status: "failed" 和 error 对象。
查看共享错误目录了解错误码、HTTP 状态和重试指导。
{
"id": "task_...",
"model": "kling-4-0-flash",
"status": "failed",
"error": {
"code": 60001,
"message": "The request was rejected by the content policy. Please revise the prompt or input images."
}
}如果提交本身超时,检查你的任务后再重新提交:第一个请求可能已经被接受。
提示
- 描述主体、场景、摄像机运动、光线和声音;视频的音频会跟随提示词。
- 用 Flash 低成本试验提示词、宽高比和参考素材;需要 1080p、关键帧、编辑或续写时,再把效果好的镜头交给 Kling 4.0。
- 为重复出场的角色建立一个含两三个清晰视角的主体,而不是只提供一张参考图片。
- 加上「无文字,无标志」防止生成虚构标记。
