图像生成（文生图/图生图）

开发中

POST

/kling/v1/images/generations

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

model_name

string

必需

模型名称 kling-v1, kling-v1-5, kling-v2

prompt

string

必需

正向文本提示词

不能超过2500个字符

negative_prompt

string

可选

负向文本提示词

不能超过2500个字符
注：图生图（即image字段不为空时）场景下，不支持负向提示词

image

string

可选

参考图像

支持传入图片Base64编码或图片URL（确保可访问）
请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。在提交数据时，请不要在Base64编码字符串前添加任何前缀，例如data:image/png;base64,。正确的参数格式应该直接是Base64编码后的字符串。
示例：
正确的Base64编码参数：
1
iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
错误的Base64编码参数（包含data:前缀）：
1
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
请仅提供Base64编码的字符串部分，以便系统能够正确处理和解析您的数据。
图片格式支持.jpg / .jpeg / .png
图片文件大小不能超过10MB，图片分辨率不小于300*300px，图片宽高比要在1:2.5 ~ 2.5:1之间
image_reference参数不为空时，当前参数必填

image_reference

string

可选

图片参考类型

枚举值：subject（角色特征参考）, face（人物长相参考）
使用face（人物长相参考）时，上传图片需仅含1张人脸。
使用 kling-v1-5 且 image 参数不为空时，当前参数必填
仅 kling-v1-5 支持当前参数

image_fidelity

number

可选

生成过程中对用户上传图片的参考强度

取值范围：[0,1]，数值越大参考强度越大

human_fidelity

number

可选

面部参考强度，即参考图中人物五官相似度

仅 image_reference 参数为 subject 时生效
取值范围：[0,1]，数值越大参考强度越大

integer

可选

生成图片数量

取值范围：[1,9]

aspect_ratio

string

可选

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

枚举值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9
不同模型版本支持的范围不同，详见能力地图

callback_url

string

可选

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

具体通知的消息schema见“Callback协议”

示例

{
    "model_name": "string",
    "prompt": "string",
    "negative_prompt": "string",
    "image": "string",
    "image_reference": "string",
    "image_fidelity": 0,
    "human_fidelity": 0,
    "n": 0,
    "aspect_ratio": "string",
    "callback_url": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.uniapi.io/kling/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model_name": "string",
    "prompt": "string",
    "negative_prompt": "string",
    "image": "string",
    "image_reference": "string",
    "image_fidelity": 0,
    "human_fidelity": 0,
    "n": 0,
    "aspect_ratio": "string",
    "callback_url": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码；具体定义错误码

message

string

错误信息

必需

request_id

string

必需

请求ID，系统生成，用于跟踪请求、排查问题

data

object

必需

task_id

string

任务ID，系统生成

必需

task_status

string

必需

任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）

created_at

integer

必需

任务创建时间，Unix时间戳、单位ms

updated_at

integer

必需

任务更新时间，Unix时间戳、单位ms

示例

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

修改于 2025-06-09 06:25:52

Openai 格式

图像生成获取状态