Omni 图像

Omni image

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/omni-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aspect_ratio": "<string>",
  "callback_url": "<string>",
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "external_task_id": "<string>",
  "image_list": [
    {
      "image": "<string>",
      "image_url": "<string>",
      "type": "<string>"
    }
  ],
  "model_name": "<string>",
  "n": 123,
  "prompt": "<string>",
  "resolution": "<string>",
  "result_type": "<string>",
  "series_amount": 4,
  "watermark_info": {
    "enabled": true
  }
}
'

import requests

url = "https://models.kapon.cloud/kling/v1/images/omni-image"

payload = {
    "aspect_ratio": "<string>",
    "callback_url": "<string>",
    "element_list": [{ "element_id": 123 }],
    "external_task_id": "<string>",
    "image_list": [
        {
            "image": "<string>",
            "image_url": "<string>",
            "type": "<string>"
        }
    ],
    "model_name": "<string>",
    "n": 123,
    "prompt": "<string>",
    "resolution": "<string>",
    "result_type": "<string>",
    "series_amount": 4,
    "watermark_info": { "enabled": True }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    aspect_ratio: '<string>',
    callback_url: '<string>',
    element_list: [{element_id: 123}],
    external_task_id: '<string>',
    image_list: [{image: '<string>', image_url: '<string>', type: '<string>'}],
    model_name: '<string>',
    n: 123,
    prompt: '<string>',
    resolution: '<string>',
    result_type: '<string>',
    series_amount: 4,
    watermark_info: {enabled: true}
  })
};

fetch('https://models.kapon.cloud/kling/v1/images/omni-image', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.kapon.cloud/kling/v1/images/omni-image",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'aspect_ratio' => '<string>',
    'callback_url' => '<string>',
    'element_list' => [
        [
                'element_id' => 123
        ]
    ],
    'external_task_id' => '<string>',
    'image_list' => [
        [
                'image' => '<string>',
                'image_url' => '<string>',
                'type' => '<string>'
        ]
    ],
    'model_name' => '<string>',
    'n' => 123,
    'prompt' => '<string>',
    'resolution' => '<string>',
    'result_type' => '<string>',
    'series_amount' => 4,
    'watermark_info' => [
        'enabled' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.kapon.cloud/kling/v1/images/omni-image"

	payload := strings.NewReader("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"result_type\": \"<string>\",\n  \"series_amount\": 4,\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/images/omni-image")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"result_type\": \"<string>\",\n  \"series_amount\": 4,\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.kapon.cloud/kling/v1/images/omni-image")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"result_type\": \"<string>\",\n  \"series_amount\": 4,\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "data": {
    "created_at": 123,
    "final_balance_deduction": {},
    "final_unit_deduction": "<string>",
    "platform_id": "<string>",
    "task_id": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "task_result": {
      "images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ],
      "result_type": "<string>",
      "series_images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ]
    },
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "updated_at": 123,
    "watermark_info": {
      "enabled": true
    }
  },
  "data_list": [
    {
      "created_at": 123,
      "final_balance_deduction": {},
      "final_unit_deduction": "<string>",
      "platform_id": "<string>",
      "task_id": "<string>",
      "task_info": {
        "external_task_id": "<string>"
      },
      "task_result": {
        "images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ],
        "result_type": "<string>",
        "series_images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ]
      },
      "task_status": "<string>",
      "task_status_msg": "<string>",
      "updated_at": 123,
      "watermark_info": {
        "enabled": true
      }
    }
  ],
  "message": "<string>",
  "request_id": "<string>"
}

POST

kling

images

omni-image

Omni image

curl --request POST \
  --url https://models.kapon.cloud/kling/v1/images/omni-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "aspect_ratio": "<string>",
  "callback_url": "<string>",
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "external_task_id": "<string>",
  "image_list": [
    {
      "image": "<string>",
      "image_url": "<string>",
      "type": "<string>"
    }
  ],
  "model_name": "<string>",
  "n": 123,
  "prompt": "<string>",
  "resolution": "<string>",
  "result_type": "<string>",
  "series_amount": 4,
  "watermark_info": {
    "enabled": true
  }
}
'

import requests

url = "https://models.kapon.cloud/kling/v1/images/omni-image"

payload = {
    "aspect_ratio": "<string>",
    "callback_url": "<string>",
    "element_list": [{ "element_id": 123 }],
    "external_task_id": "<string>",
    "image_list": [
        {
            "image": "<string>",
            "image_url": "<string>",
            "type": "<string>"
        }
    ],
    "model_name": "<string>",
    "n": 123,
    "prompt": "<string>",
    "resolution": "<string>",
    "result_type": "<string>",
    "series_amount": 4,
    "watermark_info": { "enabled": True }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    aspect_ratio: '<string>',
    callback_url: '<string>',
    element_list: [{element_id: 123}],
    external_task_id: '<string>',
    image_list: [{image: '<string>', image_url: '<string>', type: '<string>'}],
    model_name: '<string>',
    n: 123,
    prompt: '<string>',
    resolution: '<string>',
    result_type: '<string>',
    series_amount: 4,
    watermark_info: {enabled: true}
  })
};

fetch('https://models.kapon.cloud/kling/v1/images/omni-image', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://models.kapon.cloud/kling/v1/images/omni-image",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'aspect_ratio' => '<string>',
    'callback_url' => '<string>',
    'element_list' => [
        [
                'element_id' => 123
        ]
    ],
    'external_task_id' => '<string>',
    'image_list' => [
        [
                'image' => '<string>',
                'image_url' => '<string>',
                'type' => '<string>'
        ]
    ],
    'model_name' => '<string>',
    'n' => 123,
    'prompt' => '<string>',
    'resolution' => '<string>',
    'result_type' => '<string>',
    'series_amount' => 4,
    'watermark_info' => [
        'enabled' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://models.kapon.cloud/kling/v1/images/omni-image"

	payload := strings.NewReader("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"result_type\": \"<string>\",\n  \"series_amount\": 4,\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://models.kapon.cloud/kling/v1/images/omni-image")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"result_type\": \"<string>\",\n  \"series_amount\": 4,\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://models.kapon.cloud/kling/v1/images/omni-image")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"aspect_ratio\": \"<string>\",\n  \"callback_url\": \"<string>\",\n  \"element_list\": [\n    {\n      \"element_id\": 123\n    }\n  ],\n  \"external_task_id\": \"<string>\",\n  \"image_list\": [\n    {\n      \"image\": \"<string>\",\n      \"image_url\": \"<string>\",\n      \"type\": \"<string>\"\n    }\n  ],\n  \"model_name\": \"<string>\",\n  \"n\": 123,\n  \"prompt\": \"<string>\",\n  \"resolution\": \"<string>\",\n  \"result_type\": \"<string>\",\n  \"series_amount\": 4,\n  \"watermark_info\": {\n    \"enabled\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "code": 123,
  "data": {
    "created_at": 123,
    "final_balance_deduction": {},
    "final_unit_deduction": "<string>",
    "platform_id": "<string>",
    "task_id": "<string>",
    "task_info": {
      "external_task_id": "<string>"
    },
    "task_result": {
      "images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ],
      "result_type": "<string>",
      "series_images": [
        {
          "index": 123,
          "url": "<string>",
          "watermark_url": "<string>"
        }
      ]
    },
    "task_status": "<string>",
    "task_status_msg": "<string>",
    "updated_at": 123,
    "watermark_info": {
      "enabled": true
    }
  },
  "data_list": [
    {
      "created_at": 123,
      "final_balance_deduction": {},
      "final_unit_deduction": "<string>",
      "platform_id": "<string>",
      "task_id": "<string>",
      "task_info": {
        "external_task_id": "<string>"
      },
      "task_result": {
        "images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ],
        "result_type": "<string>",
        "series_images": [
          {
            "index": 123,
            "url": "<string>",
            "watermark_url": "<string>"
          }
        ]
      },
      "task_status": "<string>",
      "task_status_msg": "<string>",
      "updated_at": 123,
      "watermark_info": {
        "enabled": true
      }
    }
  ],
  "message": "<string>",
  "request_id": "<string>"
}

路径 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`
`result_type`	string	否	`single/series`，默认single；series仅Image 3.0 Omni支持
`series_amount`	int 或 string	否	组图数量2～9或`"auto"`，默认4；series模式忽略n
`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": <ID> }]
- 参考图片数量 + 主体数量 ≤ 10
resolution：默认 1k；n 默认 1；kling-image-o1 仅允许 1k/2k，kling-v3-omni 允许 1k/2k/4k
aspect_ratio：
- 默认 auto，按输入内容智能生成
- 当以参考图原始比例生成时，该参数不生效

场景一：图片参考生成

curl --request POST \
  --url https://models.kapon.cloud/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
  }'

示例响应（创建任务）

{
  "code": 0,
  "message": "success",
  "request_id": "req_...",
  "data": {
    "task_id": "task_01...",
    "task_status": "submitted",
    "created_at": 1735558800000,
    "updated_at": 1735558800000
  }
}

组图示例

{
  "model_name": "kling-v3-omni",
  "prompt": "Create a four-panel story based on the reference image",
  "image_list": [{"image": "https://example.com/reference.png"}],
  "result_type": "series",
  "series_amount": 4,
  "resolution": "4k",
  "aspect_ratio": "16:9"
}

单图结果位于 task_result.images，组图结果位于 task_result.series_images，类型由 task_result.result_type 标识。每项保留 index、url 和可选的 watermark_url。查询示例见 Legacy 任务查询。

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

aspect_ratio

string

纵横比

callback_url

string

回调通知地址

element_list

object[]

主体参考列表

Show child attributes

external_task_id

string

自定义任务ID

image_list

object[]

参考图列表

Show child attributes

model_name

string

模型名称，默认kling-image-o1

integer

生成数量

prompt

string

正向文本提示词，必须

resolution

string

清晰度

result_type

string

series_amount

default:4

组图数量；整数2至9，或字符串 auto。仅 result_type=series 时生效。

Required range: 2 <= x <= 9

watermark_info

object

水印信息

Show child attributes

Response

200 - application/json

code

integer

错误码

data

object

单个任务数据

Show child attributes

data_list

object[]

任务列表数据

Show child attributes

message

string

错误信息

request_id

string

请求ID

概述

API 2.0

Legacy 视频生成

图像生成

视频编辑

任务管理

场景一：图片参考生成

组图示例

Authorizations

Body

Response

​场景一：图片参考生成

​组图示例

Authorizations

Body

Response

场景一：图片参考生成

组图示例