外观
文生视频
POST
https://www.aipro2.com/kling/v1/videos/text2video根据文本提示词生成视频。可灵原生 camelCase 请求体；提交后返回 task_id，需轮询查询任务状态。
请求体参数
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。modestring生成模式。不传时计费侧默认 std。4k 仅 kling-v3；kling-v2-6 开 sound 须 pro。可选值stdpro4kmodel_name*string模型名称。不传时网关计费默认 kling-v1，建议显式填写。multi_shot=true 时必须为 kling-v3；mode=4k 时必须为 kling-v3。可选值kling-v1kling-v1-6kling-v2-masterkling-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 不可传。默认值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>自定义音色列表。字段可透传；当前 text2video 计费路径未单独识别 voice_list（与 image2video 不同，不影响 hasVoiceId 倍率）。
响应
任务提交成功
application/jsonKlingTaskSubmitResponsecodeinteger业务状态码示例0dataobject数据载荷（常为 Base64 或结构化对象）messagestring提示信息示例successrequest_idstring请求追踪 ID