可灵视频生成

可灵系列采用异步视频生成接口：提交任务取得 ID，轮询至 completed 状态后提取视频直链。请求体格式为标准 JSON。

接口基础信息

• 线路地址：https://img.mzfe.de（优化线路）或 https://img.zikl.dev（标准线路）
• 鉴权方式：Authorization: Bearer <API_KEY>

---

模型与输出分辨率

模型名 (Model)	输出分辨率	说明
kling-3.0-omni-720p	720p	标清流畅档
kling-3.0-omni-1080p	1080p	高清画质档

提示

分辨率已直接编码在 model 名称中，调用时不需要额外传入 size 或 resolution_name。

---

参考输入规则对照

场景	必填参考字段	格式要求与说明
普通图生视频	image_url 或 image_urls	最多 2 张： • 1 张时作为首帧 • 2 张时按数组顺序分别为首帧和尾帧
动作控制	image_url + reference_video	• image_url：角色完整外观参考图 • reference_video：提供动作、节奏与构图的参考视频 • 二者缺一不可

参考图与参考视频格式要求

• 参考图片：支持公网直链、Data URL 或裸 Base64。
• 参考视频：仅支持公网可直接读取的 HTTP(S) URL，单条文件上限 200 MiB，不支持 Base64。
• 动作控制别名：动作参考字段兼容别名 camera_motion_reference_video，新接入请统一使用 reference_video。

---

09 文生视频

仅根据文字提示词生成全新视频画面。

• 请求方式：POST
• 请求路径：/v1/videos
• Content-Type：application/json

请求参数

参数	必填	类型	说明
model	是	string	kling-3.0-omni-720p 或 kling-3.0-omni-1080p
prompt	是	string	视频画面与运镜描述
duration	是	integer	时长（秒），仅支持 5 / 10 / 15；兼容字段 seconds
aspect_ratio	否	string	画面比例："16:9"（默认）或 "9:16"
generate_audio	否	boolean	是否生成音频，默认 true；传 false 生成无声视频

时长参数提示

请显式传入 duration，时长支持 5、10、15 秒三档。

请求示例

curl -X POST "https://img.mzfe.de/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-omni-720p",
    "prompt": "一只纸船顺着雨后水洼缓缓漂流,电影感镜头",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'

响应与轮询示例

1. 提交成功响应

{
  "id": "task_xxxx",
  "status": "queued"
}

2. 发起轮询查询

curl "https://img.mzfe.de/v1/videos/{id}" \
  -H "Authorization: Bearer <API_KEY>"

3. 生成完成响应

{
  "id": "task_xxxx",
  "model": "kling-3.0-omni-720p",
  "status": "completed",
  "url": "https://xxx.mp4"
}

轮询建议

提交后建议每隔 5 ~ 10 秒查询一次。状态依次为 queued → in_progress → completed。完成后从 url 提取视频，若为 failed 表示失败。

---

10 图生视频

传入一张首帧图片驱动生成视频。

• 请求方式：POST
• 请求路径：/v1/videos
• Content-Type：application/json

请求参数

参数	必填	类型	说明
model	是	string	kling-3.0-omni-720p 或 kling-3.0-omni-1080p
prompt	是	string	运动、镜头和画面要求
image_url	是	string	首帧图片：公网直链、Data URL 或裸 Base64
duration	是	integer	5 / 10 / 15 秒；兼容 seconds
aspect_ratio	否	string	"16:9"（默认）或 "9:16"
generate_audio	否	boolean	是否生成音频，默认 true

请求示例

curl -X POST "https://img.mzfe.de/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-omni-720p",
    "prompt": "镜头缓缓推进,画面自然动起来,保持主体一致",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_url": "https://example.com/first-frame.jpg"
  }'

---

11 首尾帧视频

传入两张图片生成从首帧到尾帧的自然平滑过渡。

• 请求方式：POST
• 请求路径：/v1/videos
• Content-Type：application/json

请求参数

参数	必填	类型	说明
model	是	string	kling-3.0-omni-720p 或 kling-3.0-omni-1080p
prompt	是	string	过渡、运动和镜头要求
image_urls	是	array	包含两张图片的数组（第 1 张首帧，第 2 张尾帧）；支持公网直链、Data URL 或裸 Base64
duration	是	integer	5 / 10 / 15 秒；兼容 seconds
aspect_ratio	否	string	"16:9"（默认）或 "9:16"
generate_audio	否	boolean	是否生成音频，默认 true

注意事项

两张图片必须按首帧、尾帧的顺序放入数组中。需要首尾帧时使用 image_urls 数组，不要同时传入单图参数 image_url。

请求示例

curl -X POST "https://img.mzfe.de/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-omni-720p",
    "prompt": "从首帧自然过渡到尾帧,保持主体一致,镜头运动平滑",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ]
  }'

---

12 动作控制（参考视频）

角色图保持人物外观，参考视频提供动作、节奏与构图。该功能并非直接将原视频重绘为成片，而是让参考图的角色模仿视频动作。

• 请求方式：POST
• 请求路径：/v1/videos
• Content-Type：application/json

请求参数

参数	必填	类型	说明
model	是	string	仅 kling-3.0-omni-720p 或 kling-3.0-omni-1080p 支持
prompt	是	string	描述需要保留的角色外观特征及动作效果
image_url	是	string	角色完整外观参考（建议清晰展示全身或上半身）
reference_video	是	string / object	动作源的 HTTP(S) 公网直链（上限 200 MiB）；最多 1 条，可写为字符串或 {"url":"..."}
duration	是	integer	5 / 10 / 15 秒；兼容 seconds
aspect_ratio	否	string	"16:9"（默认）或 "9:16"
generate_audio	否	boolean	是否生成音频，默认 true

重要约束

• 传入任一动作参考字段即进入动作控制模式，角色图和动作视频缺一不可。
• 请勿同时传入两条不同的动作源。
• 动作视频应为公网可直接读取的 MP4/MOV 文件直链，避免使用网盘分享页或需要登录的链接。

请求示例

curl -X POST "https://img.mzfe.de/v1/videos" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3.0-omni-720p",
    "prompt": "保持角色外观,跟随参考视频完成同样的舞蹈动作,电影感街景",
    "duration": 10,
    "aspect_ratio": "9:16",
    "image_url": "https://example.com/character.jpg",
    "reference_video": "https://example.com/dance-motion.mp4",
    "generate_audio": false
  }'