Omni-Video

接口: POST https://4zapi.com/kling/v1/videos/omni-video

可灵 Omni 统一视频生成入口，支持文生视频、垫图、首尾帧、视频编辑、主体引用与多镜头分镜。

kling-video-v4-flash 全能参考说明

model_name 传 kling-video-v4-flash，仅 720P：mode 只能传 std 或不传，resolution 只能传 720p 或不传；传 1080p 或 pro 返回 400（不扣费）
prompt 必填；duration 为 3~30 的整数（秒），默认 5；aspect_ratio 可选 21:9、16:9、9:16、1:1、adaptive
image_list 最多 10 张（可标 first_frame / end_frame，只有尾帧会返回 400）；video_list 最多 5 段，只能作参考（refer_type 不支持 base），须为公网 http(s) 地址，每段至少 3 秒、合计不超过 30 秒；element_list 最多 7 个；voice_list 最多 3 个；素材合计不超过 15 个
提示词里用 @image_1、@video_1、@element_1 引用素材（按传入顺序编号），音色用 @ + voice_list 的 id
不支持 sound、multi_shot、mode=4k、视频编辑（refer_type=base）
按秒计费：不带参考视频时计费秒数 = 输出时长；带参考视频时计费秒数 = 输出时长 + max(参考视频总时长, 输出时长)；参考图 / 主体 / 音色不另计费

参数

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

请求体 (application/json)

model_name (string, 必填): Omni 模型名称，必填。o1 不支持 sound/4k/multi_shot；v3-omni 全功能；kling-video-v4-flash 仅 720P，不支持 sound/4k/multi_shot/视频编辑。 ["kling-video-o1", "kling-v3-omni", "kling-video-v4-flash"]
aspect_ratio (string): 画幅比例。未使用首帧且非视频编辑时建议必填。21:9、adaptive 仅 kling-video-v4-flash。 ["16:9", "9:16", "1:1", "21:9", "adaptive"]
callback_url (string): 任务完成回调地址，须公网可达
duration: 视频时长（秒）。o1: 5/10；v3-omni: 3~15；kling-video-v4-flash: 3~30 的整数，默认 5；refer_type=base 时由视频探测覆盖，可不传。
element_list (array<object>): 主体引用列表。kling-video-v4-flash 最多 7 个，提示词里用 @element_1 等引用。
external_task_id (string): 调用方外部任务 ID，用于业务关联
image_list (array<object>): 参考图列表。用于主体/场景/风格参考或首尾帧。kling-video-v4-flash 最多 10 张，提示词里用 @image_1 等引用。
mode (string): 生成模式。缺省网关补 pro；4k 仅 kling-v3-omni；kling-video-v4-flash 只能传 std 或不传（固定 720P），传 pro 返回 400。 ["std", "pro", "4k"]
multi_prompt (array<object>): 自定义分镜列表。shot_type=customize 时必填，最多 6 镜。
multi_shot (boolean): 是否多镜头，默认 false。仅 kling-v3-omni 可为 true。
prompt (string): 文本提示词，≤2500 字符。multi_shot=false 时必填；multi_shot=true 时无效。kling-video-v4-flash 必填。
shot_type (string): 分镜方式。multi_shot=true 时必填；customize 须配合 multi_prompt。 ["customize"]
sound (string): 有声开关。on 仅 kling-v3-omni；o1、kling-video-v4-flash 传 on 会 400。 ["on", "off"]
video_list (array<object>): 参考视频列表。o1 / v3-omni 最多 1 条；kling-video-v4-flash 最多 5 条，只能 refer_type=feature，每段至少 3 秒、合计不超过 30 秒。
voice_list (array<object>): 音色列表，仅 kling-video-v4-flash，最多 3 个。提示词里用 @ + id 引用（不传 id 时按 1 起的位置编号）。
watermark_info (object): 水印配置，网关透传

请求示例

{
  "duration": 5,
  "image_list": [
    {
      "image_url": "{{image_url_1}}"
    }
  ],
  "model_name": "kling-video-v4-flash",
  "prompt": "参考 @video_1 的运镜轨迹与镜头节奏，主体替换为 @image_1",
  "video_list": [
    {
      "refer_type": "feature",
      "video_url": "{{video_url}}"
    }
  ]
}