外观
图生视频
POST
https://www.aipro2.com/kling/v1/videos/image2video以输入图片为起始帧生成视频。
请求体参数
application/jsonaspect_ratiostring画幅比例（宽:高）。上游约束：常用 16:9 / 9:16 / 1:1，网关不预检枚举。可选值16:99:161:1callback_urlstring任务完成回调地址。上游任务结束后 POST 通知，须公网可达，网关原样透传。camera_controlobject镜头运动控制。不传则由模型智能匹配；网关透传，不预检具体数值范围。cfg_scalenumber生成自由度（CFG）。值越大，生成结果与 prompt 相关性越强；网关不预检范围，上游约束通常 0~1。duration*oneOf视频时长（秒），必填。非 kling-v3：仅 5 或 10；kling-v3：3~15。支持 string 或 integer，网关归一化为字符串。external_task_idstring调用方外部任务 ID，用于幂等关联与业务对账；非响应体 data.task_id。image*string输入图片 URL 或 Base64，必填。作为视频首帧参考；图生视频核心字段。格式/大小/分辨率由上游校验，网关仅校验非空。image_tailstring尾帧图片 URL 或 Base64，可选。与 image 配合实现首尾帧过渡；不传则仅由首帧生成。网关透传，不预检格式。modestring生成模式。不传时计费侧默认 std。4k 仅 kling-v3；kling-v2-6 开 sound 须 pro。可选值stdpro4kmodel_name*string模型名称。不传时网关计费默认 kling-v1，建议显式填写。比 text2video 多 kling-v1-5 / kling-v2-1。multi_shot=true 时必须为 kling-v3；mode=4k 时必须为 kling-v3。可选值kling-v1kling-v1-5kling-v1-6kling-v2-masterkling-v2-1kling-v2-1-masterkling-v2-5-turbokling-v2-6kling-v3multi_promptarray<object>自定义分镜列表。shot_type=customize 时必填，最多 6 镜。每镜 prompt≤512、duration≥1；各镜 duration 之和须等于顶层 duration（误差 ≤0.1）。multi_shotboolean是否多镜头。true 时仅 kling-v3 支持，且 prompt 无效；false 时 shot_type / multi_prompt 不可传，传了会 400。默认值falsenegative_promptstring负向提示词。描述不希望出现的内容（如模糊、低画质、变形等），网关透传。promptstring正向提示词。multi_shot=false（默认）时必填；multi_shot=true 时无效，传了会 400。描述画面运动、镜头与风格，上游约束 ≤2500 字符。shot_typestring分镜方式。multi_shot=true 时必填；multi_shot=false 时不可传。customize 须配合 multi_prompt；intelligence 由上游自动拆镜。可选值customizeintelligencesoundstring有声开关。网关仅对非空值做模型/模式校验；传 on 时触发有声计费。仅 kling-v2-6 / kling-v3 支持；v2-6 须 mode=pro。可选值onoffvoice_listarray<object>自定义音色列表。sound=on 且非空时参与计费倍率（hasVoiceId）；仅 image2video 路径识别，text2video 不计入。须配合 kling-v2-6 / kling-v3 有声能力。
响应
任务提交成功
application/jsonKlingTaskSubmitResponsecodeinteger业务状态码示例0dataobject数据载荷（常为 Base64 或结构化对象）messagestring提示信息示例successrequest_idstring请求追踪 ID