Kling 4.0 API 文档

Kling 4.0 支持文生视频、关键帧图生视频及 Omni 参考生成／编辑。API 当前提供 720p、1080p，不提供 4k。Kling 4.0 Flash 是另一项产品能力，不能由这个模型 ID 推断支持。使用 MixRoute Bearer Key 认证。kling-4.0 放在接口路径中，不放在请求体 model 字段；保留原生 prompt/contents、settings、options 结构，不包裹 metadata。这些接口不代表 Kling 4.0 已支持 motion-control。

模型规格

字段	说明
`ID`	kling-4.0
`POST`	文生视频 / 图生视频 / Omni 参考与编辑

通用设置与选项

字段	说明
`settings.resolution`	720p 或 1080p。厂商默认 1080p；在 MixRoute 请求中应显式指定，不沿用旧网关默认值。
`settings.duration`	3-30 的整数秒。厂商优先采用显式设置，其次为提示词中指定的时长，否则 10 秒。Omni 编辑在回退到 10 秒前，会采用四舍五入后的 base_video 时长。显式指定可避免歧义。
`options`	通用选项仍为 options.callback_url、options.external_task_id、options.watermark_info.enabled。自定义任务 ID 不是 MixRoute 轮询 ID，也不代表请求具备幂等性。

纯英文最多 26,000 字符，纯非英文最多 11,000 字符；混合输入须满足 E / 26000 + N / 11000 <= 1。在提示词中描述动作顺序和镜头变化，不要照搬旧版 multi_shot 开关。 E 为英文字符数，N 为非英文字符数。

4.0 文生／图生接口没有 audio、multi_shot 开关。省略 settings.audio 和 settings.multi_shot，不要传旧版 audio=off 配置。

文生视频

字段	说明
`prompt`	必填的顶层 prompt。文生视频接口不接收媒体输入。
`settings.aspect_ratio`	21:9、16:9、9:16、1:1，厂商默认 16:9；文生视频接口不要传 adaptive。

设置 MIXROUTE_API_KEY，并将 example.com 图片地址替换为可访问的素材。仅提交一次；超时不代表任务未创建。

curl --request POST "https://api.mixroute.ai/kling/text-to-video/kling-4.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "prompt": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting.",
  "settings": {
    "resolution": "720p",
    "duration": 3,
    "aspect_ratio": "16:9"
  }
}'

图生视频

使用 prompt 项和 first_frame、middle_frame、last_frame 图片项。图片用 url；可选的唯一 id 可在提示词中以 @id 引用。图片和提示词引用按时间顺序排列；本协议不要求额外 timestamp 字段。最多 10 张图片；JPG/JPEG/PNG，每张不超过 30 MB，宽高均至少 300 px，宽高比 2:5 至 5:2。使用公开 URL 或 Base64。图生接口没有 settings.aspect_ratio；视频、Element 和音色参考使用 Omni。

curl --request POST "https://api.mixroute.ai/kling/image-to-video/kling-4.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "type": "prompt",
      "text": "The scene moves smoothly from @start through @middle to @end."
    },
    {
      "type": "first_frame",
      "id": "start",
      "url": "https://example.com/first-frame.png"
    },
    {
      "type": "middle_frame",
      "id": "middle",
      "url": "https://example.com/middle-frame.png"
    },
    {
      "type": "last_frame",
      "id": "end",
      "url": "https://example.com/last-frame.png"
    }
  ],
  "settings": {
    "resolution": "720p",
    "duration": 5
  }
}'

Omni 参考与编辑

必须包含 prompt 项。支持 first_frame、middle_frame、last_frame、refer_image、feature_video、base_video、element、voice。图片／视频使用 url，Element 使用 element_id，音色使用 voice_id。设置唯一 id 并以 @id 引用；素材 ID 须对所路由的上游账户可访问。 element 和 voice 项除了 element_id 或 voice_id，还必须填写 id。 Omni 中有多个 middle_frame 或 refer_image 时，图片 id 必填。first_frame、last_frame、refer_image 混用时，首帧应是第一张图片，尾帧是最后一张。

字段	说明
`settings.aspect_ratio`	21:9、16:9、9:16、1:1 或 adaptive（厂商默认）。显式画幅优先；adaptive 按提示词、base_video、关键帧、feature_video 的顺序取值，多参考视频或无适用来源时回退到 16:9。
`settings.audio`	native（厂商默认）或 original。original 要求 base_video 或 feature_video，且不能带 voice 参考；优先保留 base_video 音频，否则取第一个 feature_video。off 和 multi_shot 不是 4.0 参数。

媒体限制

图片、视频、Element、音色合计最多 15 项。图片最多 10 张；参考视频最多 5 个，视频角色 Element 同时占用这个上限。Element 最多 7 个，其中视频角色最多 3 个；音色最多 3 个；base_video 最多 1 个。 JPG/JPEG/PNG，每张不超过 30 MB，宽高均至少 300 px，宽高比 2:5 至 5:2。使用公开 URL 或 Base64。 MP4/MOV，每个不超过 300 MB；单个视频和视频总时长均为 3-30 秒，总时长包括视频角色 Element。宽高 700-4553 px，总像素不超过 8,294,400，宽高比 2:5 至 5:2；输入 24-60 fps，输出 24 fps。

curl --request POST "https://api.mixroute.ai/kling/omni-video/kling-4.0" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "contents": [
    {
      "type": "prompt",
      "text": "A slow camera move around the ceramic mug in @mug on a white tabletop."
    },
    {
      "type": "refer_image",
      "id": "mug",
      "url": "https://example.com/mug.png"
    }
  ],
  "settings": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "adaptive",
    "audio": "native"
  }
}'

任务结果

检查 HTTP 状态及 code=0，保存提交响应的 data.id，使用这个 MixRoute 任务 ID 单独查询。succeeded 后从 data[0].outputs 的 type=video 项读取 URL；不要把 API Key 发给结果 CDN。

curl --get "https://api.mixroute.ai/kling/tasks" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --data-urlencode "task_ids=$KLING_TASK_ID"

任务结果 Kling 4.0 上游计费区分 input_duration 和 output_duration，输入时长包括参考视频和视频角色 Element。网关 usage 可能缺失或为空，不能只用 outputs[].duration 推算 MixRoute 最终费用，也不要套用旧型号费率；以模型广场和账单为准。

首页

模型介绍

Kling 4.0

模型规格

通用设置与选项

文生视频

图生视频

Omni 参考与编辑

媒体限制

任务结果

​模型规格

​通用设置与选项

​文生视频

​图生视频

​Omni 参考与编辑

​媒体限制

​任务结果

模型规格

通用设置与选项

文生视频

图生视频

Omni 参考与编辑

媒体限制

任务结果