Kling 4.0 关键帧生成视频

接口

POST /videos/generations

完整 URL: https://modelfold.ai/v1/videos/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

模型参数直接放在 JSON 请求体中，不要套 input。请求等待生成完成后返回 data[].url；支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。

生成任务的输入参数。

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	用于生成任务的模型名称。必填字段。 - 该接口必须使用 kling-4.0/keyframe-to-video 模型 默认值："kling-4.0/keyframe-to-video"。 可选值：kling-4.0/keyframe-to-video。 示例：kling-4.0/keyframe-to-video。
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。描述要生成的视频。 用 @first_frame、@keyframe_1、@keyframe_2…、@last_frame 引用本次请求已传入的帧，只能引用实际提供的帧。 每个 @ 引用都必须能匹配到本次请求已传入的素材，否则请求会被拒绝。引用按已声明名称做最长匹配；若匹配到的名称以字母、数字或下划线结尾，紧跟的下一个字符不能再是字母、数字或下划线。 minLength: 1. maxLength: 2000. 示例：@first_frame 里的女孩出门，经过 @keyframe_1 的街道，最后到达 @last_frame 的晚会。
duration	integer	否	输出视频时长（秒），3–30 的整数，默认 5。 同时限制总帧数（首帧 + 中间帧 + 尾帧）： - 3 秒 → 4 帧 - 4 秒 → 5 帧 - 5 秒 → 6 帧 - 6 秒 → 7 帧 - 7 秒 → 8 帧 - 8 秒 → 9 帧 - 9 秒及以上 → 10 帧 默认值：5。 minimum: 3. maximum: 30. 示例：5。
resolution	string	否	输出分辨率：720p 或 1080p，默认 720p。 默认值："720p"。 可选值：720p / 1080p。 示例：720p。
aspect_ratio	string	否	输出画面比例。只在一帧都不传时生效（纯文生视频），默认 16:9；传了任意帧时跟随首帧比例。 可选值：auto / 16:9 / 9:16 / 1:1 / 21:9。 示例：auto。
first_frame_url	string	否	首帧图片地址。提示词里用 @first_frame 引用。 pattern: ^https?://.
keyframe_urls	array<string>	否	中间帧图片地址，按时间顺序，最多 8 张（同时受 duration 限制）。提示词里用 @keyframe_1、@keyframe_2… 引用。 默认值：[]。 maxItems: 8.
last_frame_url	string	否	尾帧图片地址。提示词里用 @last_frame 引用。 pattern: ^https?://.

请求示例

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-4.0/keyframe-to-video",
  "prompt": "@first_frame 中的人物缓缓转头看向镜头。",
  "duration": 3,
  "resolution": "720p",
  "first_frame_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_2_dark_hair_fighter_ref.png"
}'

{
  "model": "kling-4.0/keyframe-to-video",
  "prompt": "@first_frame 中的人物缓缓转头看向镜头。",
  "duration": 3,
  "resolution": "720p",
  "first_frame_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release-note/ch12_2_dark_hair_fighter_ref.png"
}

计费与默认值

• 两条线路使用相同的对外字段及计费规则。省略 duration / resolution 时为 5 秒 / 720p。不传帧仍支持纯文生视频，官方线路会改用全能接口承接；传帧时忽略 aspect_ratio。
• 不带视频输入：积分 = 向上取整（基础费率 × 输出秒数 × 当前定价系数）。720p 基础费率为 28.5 积分/秒，1080p 为 42.5。按当前系数，720p 的 3 秒为 112 积分，5 秒为 186；价格可能调整，以服务端报价为准。
• 默认生成原生音频，没有关闭音频参数。

下方响应以 720p、3 秒为例。usage.credits 为实扣积分，balance 为剩余积分，latencyMs 为请求耗时（毫秒）；rate、seconds、resolution、source 为报价口径。全能参考还返回 inputSeconds，带视频时另有 inputVideos；数值和可选字段随请求变化。created 为秒级 Unix 时间戳，data 为可下载视频地址列表。

响应

200 — 生成完成。usage 返回实际计费明细；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {
    "credits": 112,
    "rate": 28.5,
    "seconds": 3,
    "resolution": "720p",
    "source": "rate",
    "balance": 888,
    "latencyMs": 120000
  }
}