跳转到主要内容
POST
/
kling
/
v1
/
images
/
omni-image
Kling 全能图像任务
curl --request POST \
  --url https://api.powertokens.ai/kling/v1/images/omni-image \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v3-omni",
  "prompt": "Create a three-frame product storyboard",
  "result_type": "series"
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": "<string>"
    },
    "created_at": 123,
    "updated_at": 123
  },
  "request_id": "<string>"
}

授权

​
Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>。

请求体

application/json
​
model_name
enum<string>
必填

模型名称

可用选项:
kling-v3-omni
​
prompt
string
必填

文本提示词，可包含正向描述和负向描述

  • 可将提示词模板化来满足不同的图像生成需求
  • 不能超过 2500 个字符
  • 通过 <<<>>> 的格式来指定某个图片，如：<<<image_1>>>
Maximum string length: 2500
​
image_list
object[]

参考图列表，用 key:value 承载，如下：

"image_list": [{ "image": "image_url" }]
  • 支持传入图片 Base64 编码或图片 URL（确保可访问）
  • 图片格式支持 .jpg / .jpeg / .png
  • 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间
  • 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10
  • image_url 参数值不得为空
​
element_list
object[]

主体参考列表，基于主体库中主体的 ID 配置

  • 用 key:value 承载，如下： "element_list":[{ "element_id": 829836802793406551 }]

  • 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10

​
resolution
enum<string>
默认值:1K

生成图片的清晰度

可用选项:
1k,
2k,
4K
​
result_type
enum<string>
默认值:single

生成结果单图/组图切换开关

可用选项:
single,
series
​
aspect_ratio
enum<string>
默认值:auto

生成图片的画面纵横比（宽:高）

枚举值: 16:9 9:16 1:1 4:3 3:4 3:2 2:3 21:9 auto

  • 其中：auto为根据传入内容智能生成图片宽高比
可用选项:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9,
auto
​
n
integer
默认值:1

生成图片数量

  • 取值范围：[1, 9]
  • 当 result_type 值为 series 时，当前参数无效
必填范围: 1 <= x <= 9
​
series_amount

生成组图的图片数量

枚举值：2 3 4 5 6 7 8 9 auto

  • 其中：auto 为根据传入内容智能选择生成图片的数量
  • 使用 auto 时，会占用与实际生成数量对应的并发量
  • 当 result_type 值为 single 时，当前参数无效
必填范围: 2 <= x <= 9
​
watermark_info
object

是否同时生成含水印的结果。

​
callback_url
string

本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知

​
external_task_id
string

自定义任务 ID

  • 用户自定义任务 ID，传入不会覆盖系统生成的任务 ID，但支持通过该 ID 进行任务查询
  • 请注意，单用户下需要保证唯一性

响应

任务已接受。

​
code
integer
必填

Kling 响应码。0 表示任务已被接受。

​
message
string
必填

Kling 响应消息。

​
data
object
必填
​
request_id
string

上游请求标识符（如有提供）。