Kling-3.0 motion-control

接口

POST /videos/generations

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

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

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

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	用于生成任务的模型名称。必填字段。 - 此端点必须为 kling-3.0/motion-control 默认值："kling-3.0/motion-control"。 可选值：kling-3.0/motion-control。 示例：kling-3.0/motion-control。
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。(可选) 文本提示词，用于引导生成动画内容，可为空或 0-2500 字符 maxLength: 2000.
input_urls	array<string>	是	(必填)包含一个图片url maxItems: 1.
video_urls	array<string>	是	(必填)包含一个视频url maxItems: 1.
mode	string	否	可选。输出分辨率："720p"（默认）或 "1080p"。 默认值："720p"。 可选值：720p / 1080p。 示例：720p。
character_orientation	string	否	(可选) 角色朝向参考来源。video: 参考视频 (推荐)；image: 参考图片。默认值: video

请求示例

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "kling-3.0/motion-control",
  "input_urls": [
    "https://example.com/reference.png"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "prompt": "A paper boat drifting down a rainy street.",
  "mode": "720p"
}'

{
  "model": "kling-3.0/motion-control",
  "input_urls": [
    "https://example.com/reference.png"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "prompt": "A paper boat drifting down a rainy street.",
  "mode": "720p"
}

响应

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

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}