Omni-Image（O1）

OpenAPI Specification

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

鉴权：请求头 Authorization 传令牌，取值形如 Bearer {{YOUR_API_KEY}}（该字段非必填）。

请求体参数（application/json）

必传字段只有 prompt 一个，其余都可省略。

• prompt：string，必传；正向提示文本。原文档的文字说明是不能超过 500 个字符，而 schema 上标注的 maxLength 为 5000。
• negative_prompt：string，可选；负向提示文本。原文档的文字说明是不能超过 200 个字符，schema 上标注的 maxLength 为 2000。
• image：string，可选；参考图，既能给 Base64 也能给图片 URL，格式限 .jpg、.jpeg、.png，体积不超过 10MB。
• image_fidelity：number，可选；决定生成时对这张参考图的依赖程度，取值落在 [0,1] 区间。
• n：integer，可选；出图张数，取值落在 [1,9] 区间。
• aspect_ratio：string，可选；画面宽高比，可填 16:9、9:16、1:1、4:3、3:4、3:2、2:3（原文档枚举清单里的最后一项带有一个前导空格）。
• callback_url：string，可选；本次任务完成后的回调地址。
• model_name：string，可选；不传时取 kling-v1，另外还可填 kling-v1-5、kling-v2。

响应

• 200：返回 JSON 对象，字段如下。
• code：integer，出错时的错误码。
• message：string，错误提示信息。
• request_id：string，系统为本次请求生成的编号，便于追踪与排查。
• data：object。其中 task_id（string）是系统生成的任务编号；task_status（string）是任务所处阶段，可取 submitted（已提交）、processing（处理中）、succeed（已成功）、failed（已失败）；created_at（integer）是创建时刻，updated_at（integer）是更新时刻，两者均为 Unix 毫秒时间戳。

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