4Z API

多图参考生视频

接口: POST https://4zapi.com/kling/v1/videos/multi-image2video

参数

  • Content-Type (header, string): 请求体 Content-Type,一般为 application/json
  • Authorization (header, string): Bearer API Key

请求体 (application/json)

  • duration (必填): 视频时长(秒),必填。仅 5 或 10;支持 string / integer,网关归一化为字符串。缺失时在 Relay 计费层报 duration must be 5 or 10。
  • image_list (array<object>, 必填): 参考图列表,必填。1~4 张;每项须含 image 字段(URL 或 Base64)。网关只校验 image 非空,格式/大小由上游校验。
  • model_name (string, 必填): 模型名称,必填。网关仅允许 kling-v1-6;缺失或其他值返回 400。 ["kling-v1-6"]
  • aspect_ratio (string): 画幅比例。可选;传入时网关预检枚举,不传则由上游决定。 ["16:9", "9:16", "1:1"]
  • callback_url (string): 任务完成回调地址,须公网可达,网关原样透传。
  • cfg_scale (number): 生成自由度(CFG),可选。网关透传,不预检范围。
  • external_task_id (string): 调用方外部任务 ID,用于幂等关联与业务对账;非响应 data.task_id。
  • mode (string): 生成模式。不传时计费侧默认 std。不支持 4k。 ["std", "pro"]
  • negative_prompt (string): 负向提示词,可选。网关透传,不预检长度(仅 prompt 有 2500 校验)。
  • prompt (string): 正向提示词,可选。网关不强制必填;若传入须 ≤2500 字符。建议填写以引导运动与风格。

请求示例

{
  "aspect_ratio": "16:9",
  "duration": "5",
  "image_list": [
    {
      "image": "{{image_url_1}}"
    },
    {
      "image": "{{image_url_2}}"
    }
  ],
  "mode": "std",
  "model_name": "kling-v1-6",
  "prompt": "A cinematic scene blending the subjects from reference images, smooth camera movement"
}