Omni-Video

OpenAPI Specification

接口：POST /kling/v1/videos/omni-video（完整地址 https://api.allyang.cn/kling/v1/videos/omni-video）

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}（原文标注为可选）。

请求体参数（application/json）

• model_name：必填，string，模型标识，示例值 kling-video-o1。
• prompt：必填，string，文本提示词，可同时包含正向与负向描述，不超过 2500 个字符；schema 中标注 maxLength 为 5000；可用 <<<element_1>>>、<<<image_1>>>、<<<video_1>>> 这类格式指定某个主体、图片或视频。
• aspect_ratio：必填，string，成视频的画面纵横比（宽:高），取值 16:9、9:16、1:1；未使用首帧参考或视频编辑功能时该参数必填。
• mode：可选，string，生成视频的模式，取 std（高性能） 或 pro（高表现）；不同模型版本、视频模式的支持范围不同。
• duration：可选，string，生成视频时长（单位 s），取 5 或 10；文生视频、首帧图生视频、首尾帧生视频仅支持 5 与 10；使用视频编辑功能（refer_type 为 base）时输出时长与传入视频相同、该参数无效。
• callback_url：可选，string，本次任务结果回调通知地址。
• image_list：可选，array，参考图列表；以 key:value 承载，元素含 image_url 与 type，type 取 first_frame（首帧）或 end_frame（尾帧）；暂不支持仅尾帧，有尾帧图时必须有首帧图；首帧或首尾帧生视频时不能使用视频编辑功能；支持图片 Base64 编码或可访问的图片 URL；格式支持 .jpg / .jpeg / .png；单图不能超过 10MB，宽高尺寸不小于 300px，宽高比在 1:2.5 ~ 2.5:1 之间；有参考视频时参考图不得超过 4 张，无参考视频时不得超过 7 张；数组超过 2 张图片时不支持设置尾帧。
• element_list：可选，array，主体参考列表；以 key:value 承载，元素含 element_id（long），取自主体库中的主体 ID；有参考视频时参考图片与参考主体数量之和不得超过 4，无参考视频时不得超过 7。
• video_list：可选，array，参考视频，通过 URL 方式获取；以 key:value 承载，元素含 video_url、refer_type、keep_original_sound，其中 refer_type 取 feature（特征参考视频）或 base（待编辑视频，默认），keep_original_sound 取 yes（保留）或 no（不保留）；参考视频为待编辑视频时不能定义视频首尾帧；格式仅支持 MP4/MOV，时长 ≥ 3 秒且 ≤ 10 秒，宽高尺寸介于 720px（含）与 2160px（含）之间，帧率 24fps～60fps、生成时输出为 24fps；至多支持上传 1 段视频，大小不超过 200MB。

响应

• 200：成功，返回 JSON 对象：
  • code：integer，错误码；message：string，错误信息；request_id：string，系统生成、用于跟踪请求与排查问题。
  • data：object，含 task_id（string，系统生成）、task_status（string，取 submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败））、created_at 与 updated_at（均 integer，Unix 时间戳、单位 ms）。
  • 必填：code、message、request_id、data；data 内必填 task_id、task_status、created_at、updated_at。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。

本接口支持多模态输入（主体、图片、视频等），可与提示词组合使用。