Claude Opus 5.5 已在 SeedRouter 上线

Video

Kling 4.0 Flash

View Markdown

用文本、参考图片、参考视频和可复用的角色或道具主体,生成 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文本、参考图片、参考视频、主体720p3–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
请求头值
AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/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_urlsURL 列表无参考图片,最多 10 张,按顺序用 @image_1、@image_2、… 提及。
video_urlsURL 列表无参考视频,最多 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@name7 个主体,其中最多 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必填必填
typeimage(默认)video
image_urls2–4 个视角,首张为主视角不接受
video_url不接受一段 3–8 秒的单镜头角色视频,最短边至少 700 像素
tagcharacter、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 rate

input 是参考视频和视频主体的总时长,向上取整到整秒。接受请求时会测量时长,所以预留金额就是最终扣费金额。例:用 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。
  • 为重复出场的角色建立一个含两三个清晰视角的主体,而不是只提供一张参考图片。
  • 加上「无文字,无标志」防止生成虚构标记。

相关