图生视频

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

以输入图片为起始帧生成视频。

请求体 (application/json)

duration (必填): 视频时长（秒），必填。非 kling-v3：仅 5 或 10；kling-v3：3~15。支持 string 或 integer，网关归一化为字符串。
image (string, 必填): 输入图片 URL 或 Base64，必填。作为视频首帧参考；图生视频核心字段。格式/大小/分辨率由上游校验，网关仅校验非空。
model_name (string, 必填): 模型名称。不传时网关计费默认 kling-v1，建议显式填写。比 text2video 多 kling-v1-5 / kling-v2-1。multi_shot=true 时必须为 kling-v3；mode=4k 时必须为 kling-v3。 ["kling-v1", "kling-v1-5", "kling-v1-6", "kling-v2-master", "kling-v2-1", "kling-v2-1-master", "kling-v2-5-turbo", "kling-v2-6", "kling-v3"]
aspect_ratio (string): 画幅比例（宽:高）。上游约束：常用 16:9 / 9:16 / 1:1，网关不预检枚举。 ["16:9", "9:16", "1:1"]
callback_url (string): 任务完成回调地址。上游任务结束后 POST 通知，须公网可达，网关原样透传。
camera_control (object): 镜头运动控制。不传则由模型智能匹配；网关透传，不预检具体数值范围。
cfg_scale (number): 生成自由度（CFG）。值越大，生成结果与 prompt 相关性越强；网关不预检范围，上游约束通常 0~1。
external_task_id (string): 调用方外部任务 ID，用于幂等关联与业务对账；非响应体 data.task_id。
image_tail (string): 尾帧图片 URL 或 Base64，可选。与 image 配合实现首尾帧过渡；不传则仅由首帧生成。网关透传，不预检格式。
mode (string): 生成模式。不传时计费侧默认 std。4k 仅 kling-v3；kling-v2-6 开 sound 须 pro。 ["std", "pro", "4k"]
multi_prompt (array<object>): 自定义分镜列表。shot_type=customize 时必填，最多 6 镜。每镜 prompt≤512、duration≥1；各镜 duration 之和须等于顶层 duration（误差 ≤0.1）。
multi_shot (boolean): 是否多镜头。true 时仅 kling-v3 支持，且 prompt 无效；false 时 shot_type / multi_prompt 不可传，传了会 400。
negative_prompt (string): 负向提示词。描述不希望出现的内容（如模糊、低画质、变形等），网关透传。
prompt (string): 正向提示词。multi_shot=false（默认）时必填；multi_shot=true 时无效，传了会 400。描述画面运动、镜头与风格，上游约束 ≤2500 字符。
shot_type (string): 分镜方式。multi_shot=true 时必填；multi_shot=false 时不可传。customize 须配合 multi_prompt；intelligence 由上游自动拆镜。 ["customize", "intelligence"]
sound (string): 有声开关。网关仅对非空值做模型/模式校验；传 on 时触发有声计费。仅 kling-v2-6 / kling-v3 支持；v2-6 须 mode=pro。 ["on", "off"]
voice_list (array<object>): 自定义音色列表。sound=on 且非空时参与计费倍率（hasVoiceId）；仅 image2video 路径识别，text2video 不计入。须配合 kling-v2-6 / kling-v3 有声能力。

请求示例

{
  "duration": "5",
  "image": "{{image_url}}",
  "mode": "pro",
  "model_name": "kling-v2-6",
  "prompt": "A panda drinks coffee in a cozy cafe"
}