文生视频

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

根据文本提示词生成视频。可灵原生 camelCase 请求体；提交后返回 task_id，需轮询查询任务状态。

请求体 (application/json)

• duration (必填): 视频时长（秒），必填。非 kling-v3：仅 5 或 10；kling-v3：3~15。支持 string 或 integer，网关归一化为字符串。
• model_name (string, 必填): 模型名称。不传时网关计费默认 kling-v1，建议显式填写。multi_shot=true 时必须为 kling-v3；mode=4k 时必须为 kling-v3。 ["kling-v1", "kling-v1-6", "kling-v2-master", "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。
• 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 不可传。
• 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>): 自定义音色列表。字段可透传；当前 text2video 计费路径未单独识别 voice_list（与 image2video 不同，不影响 hasVoiceId 倍率）。

请求示例

{
  "aspect_ratio": "16:9",
  "duration": "5",
  "mode": "std",
  "model_name": "kling-v1",
  "prompt": "A drone shot of a beautiful coastline at golden hour sunset"
}