Appearance
Omni 图像
接口与可灵官网一致;支持 Omni Image O1 与 Kling Image 3.0 Omni
- 路径
POST /kling/v1/images/omni-image - 与官网一致:本页所有请求体、字段命名与返回结构与可灵官网保持一致
- 字段详解:请参考官网权威文档
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model_name | string | 否 | 模型名称,默认 kling-image-o1。可选:kling-image-o1、kling-v3-omni |
prompt | string | 是 | 文本提示词 |
image_list | array | 否 | 参考图片列表 |
element_list | array | 否 | 主体参考列表 |
resolution | string | 否 | 清晰度:1k/2k;kling-v3-omni 额外支持 4k |
n | int | 否 | 生成图片数量 [1,9] |
aspect_ratio | string | 否 | 纵横比:16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9、auto |
watermark_info | object | 否 | 是否生成含水印结果 |
callback_url | string | 否 | 回调通知地址 |
external_task_id | string | 否 | 自定义任务ID |
请求体补充说明
prompt:支持通过<<<image_1>>>引用图片占位符;长度 ≤ 2500 字符model_name仅支持kling-image-o1、kling-v3-omni。image_list结构:- 字段:
image(URL 或 Base64,官方上游字段) - 兼容:
image_url(平台兼容输入,转发上游时会映射为image) - 约束:
.jpg/.jpeg/.png;大小 ≤ 10MB;最小边 ≥ 300px;宽高比 1:2.5 ~ 2.5:1
- 字段:
element_list结构:[{ "element_id": }]- 参考图片数量 + 主体数量 ≤ 10
resolution:默认1k;n默认 1;kling-image-o1仅允许1k/2k,kling-v3-omni允许1k/2k/4kaspect_ratio:- 默认
auto,按输入内容智能生成 - 当以参考图原始比例生成时,该参数不生效
- 默认
场景一:图片参考生成
bash
curl --request POST \
--url https://aiapi.fhddos.com/kling/v1/images/omni-image \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model_name": "kling-image-o1",
"prompt": "<<<image_1>>>同风格的科幻城市",
"image_list": [
{"image": "https://example.com/ref.jpg"}
],
"aspect_ratio": "16:9",
"resolution": "1k",
"n": 1
}'示例响应(创建任务)
json
{
"code": 0,
"message": "success",
"request_id": "req_...",
"data": {
"task_id": "task_01...",
"task_status": "submitted",
"created_at": 1735558800000,
"updated_at": 1735558800000
}
}OpenAPI
yaml
openapi: 3.0.3
info:
title: Fhddos Core API
version: '1.0'
description: >-
Core OpenAI-compatible and model-family endpoints used by the Fhddos user
docs.
servers:
- url: https://aiapi.fhddos.com
security:
- BearerAuth: []
paths:
/kling/v1/images/omni-image:
post:
tags:
- Kling
summary: Kling omni image
requestBody:
$ref: '#/components/requestBodies/JsonObject'
responses:
'200':
$ref: '#/components/responses/JsonObject'
components:
requestBodies:
JsonObject:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GenericObject'
responses:
JsonObject:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/GenericObject'
schemas:
GenericObject:
type: object
additionalProperties: true
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'Authorization: Bearer <token>'