跳转到主要内容
POST
/
kling
/
v1
/
images
/
generations
Kling 图像生成任务
curl --request POST \
  --url https://api.powertokens.ai/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v3",
  "prompt": "A clean product photo on a white background",
  "aspect_ratio": "1:1",
  "n": 1
}
'
{
  "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
​
prompt
string
必填

正向文本提示词

Maximum string length: 2500
​
negative_prompt
string

负向文本提示词 注：图生图（即 image 字段不为空时）场景下，不支持负向提示词

Maximum string length: 2500
​
image
string

参考图像

  • 支持传入图片 Base64 编码或图片 URL（确保可访问）

Base64 编码说明： 请注意，若您使用base64的方式，请确保您传递的所有图像数据参数均采用Base64编码格式。使用 Base64 时，请不要添加任何前缀如 data:image/png;base64,，只需提供 Base64 编码字符串本身。

正确示例： iVBORw0KGgoAAAANSUhEUgAAAAUA

错误示例: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...

  • 图片格式支持 .jpg / .jpeg / .png
  • 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比介于 1:2.5 ~ 2.5:1 之间
  • image_reference 参数不为空时，当前参数必填
​
image_reference
enum<string>

图片参考类型。

  • subject（角色特征参考）, face（人物长相参考）
  • 使用 face（人物长相参考）时，上传图片需仅含 1 张人脸
可用选项:
subject,
face
​
image_fidelity
number

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

必填范围: 0 <= x <= 1
​
human_fidelity
number

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

必填范围: 0 <= x <= 1
​
element_list
object[]

主体参考列表，基于主体库中的主体 ID 配置。 用 key:value 承载，格式如上： "element_list":[{ "element_id": long },{ "element_id": long }] 参考主体数量与参考图片数量有关，参考主体数量和参考图片数量之和不得超过 10

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

生成图片的清晰度。

可用选项:
1k,
2k
​
n
integer
默认值:1

生成图片数量。

必填范围: 1 <= x <= 9
​
aspect_ratio
enum<string>
默认值:16:9

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

可用选项:
1:1,
16:9,
4:3,
3:2,
2:3,
3:4,
9:16,
21:9
​
watermark_info
object

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

​
callback_url
string

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

​
external_task_id
string

自定义任务 ID

响应

任务已受理。

​
code
integer
必填

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

​
message
string
必填

Kling 响应消息。

​
data
object
必填
​
request_id
string

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