# Omni-Image（O1）

**方法**: `POST`
**路径**: `/kling/v1/images/omni-image`

本文档不实时更新，完整版请查看官方文档：<https://app.klingai.com/cn/dev/document-api/apiReference/model/OmniImage>

## 请求参数

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
model_name
string
可选
kling-v1-5,kling-v2
默认值:
kling-v1
prompt
string
必需
正向文本提示，必须，不能超过500个字符
<= 5000 字符
negative_prompt
string
可选
负向文本提示，可选，不能超过200个字符
<= 2000 字符
image
string
可选
参考图片，可选，支持Base64编码或图片URL，支持.jpg / .jpeg / .png格式，大小不能超过10MB
image_fidelity
number
可选
生成过程中对用户上传图片的参考强度，可选，取值范围：[0,1]
>= 0
<= 1
n
integer
可选
生成图片数量，可选，取值范围：[1,9]
>= 1
<= 9
aspect_ratio
enum<string>
可选
生成图片的纵横比，可选，枚举值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
枚举值:
16:9
9:16
1:1
4:3
3:4
3:2
2:3
callback_url
string
可选
本次任务结果回调通知地址，可选
示例
{
"model_name"
:
"kling-v1"
,
"prompt"
:
"string"
,
"negative_prompt"
:
"string"
,
"image"
:
"string"
,
"image_fidelity"
:
0
,
"n"
:
1
,
"aspect_ratio"
:
"16:9"
,
"callback_url"
:
"string"
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/kling/v1/images/omni-image' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "kling-v1",
    "prompt": "string",
    "negative_prompt": "string",
    "image": "string",
    "image_fidelity": 0,
    "n": 1,
    "aspect_ratio": "16:9",
    "callback_url": "string"
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
code
integer
必需
错误码；具体定义错误码
message
string
错误信息
必需
request_id
string
必需
请求ID，系统生成，用于跟踪请求、排查问题
data
object
必需
task_id
string
任务ID，系统生成
必需
task_status
enum<string>
必需
任务状态，枚举值：submitted（已提交）、process任务创建时间，Unix时间戳、单位msing（处理中）、succeed（成功）、failed（失败）
枚举值:
submitted（已提交）
processing（处理中）
succeed（成功）
failed（失败）
created_at
integer
必需
任务创建时间，Unix时间戳、单位ms
updated_at
integer
必需
任务更新时间，Unix时间戳、单位ms
```

#### 示例

```json
{
    "code": 0,
    "message": "string",
    "request_id": "string",
    "data": {
        "task_id": "string",
        "task_status": "string",
        "created_at": 0,
        "updated_at": 0
    }
}
```