Skip to main content
POST
Kling 多图生图任务

授权

​
Authorization
string
header
必填

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

请求头

​
Content-Type
string
默认值:application/json
必填

数据交换格式

请求体

application/json
​
model_name
enum<string>
必填

模型名称

可用选项:
kling-v2
​
subject_image_list
object[]
必填

主体参考图片列表

  • 最多支持 4 张图片，最少支持 1 张图片，用 key:value 承载，如下： "subject_image_list":[ { "subject_image":"image_url" }, { "subject_image":"image_url" }, { "subject_image":"image_url" }, { "subject_image":"image_url" }]
  • API 端无裁剪逻辑，请直接上传已选主体后的图片
  • 支持传入图片 Base64 编码或图片 URL（确保可访问）
  • 注意：若您使用 Base64 方式，请不要在 Base64 编码字符串前添加任何前缀（如 data:image/png;base64,），直接传递 Base64 编码后的字符串即可。
  • 正确的 Base64 编码参数：

iVBORw0KGgoAAAANSUhEUgAAAAUA...

  • 错误的 Base64 编码参数（包含 data: 前缀）：

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...

  • 图片格式支持 .jpg / .jpeg / .png
  • 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间
Required array length: 1 - 4 elements
​
prompt
string

正向文本提示词

  • 不能超过2500个字符
Maximum string length: 2500
​
negative_prompt
string

负向文本提示词

  • 不能超过2500个字符
Maximum string length: 2500
​
scene_image
string

场景参考图

  • 支持传入图片 Base64 编码或图片 URL（确保可访问）
  • 注意：若您使用 Base64 方式，请不要在 Base64 编码字符串前添加任何前缀（如 data:image/png;base64,），直接传递 Base64 编码后的字符串即可。
  • 正确的 Base64 编码参数：

iVBORw0KGgoAAAANSUhEUgAAAAUA...

  • 错误的 Base64 编码参数（包含 data: 前缀）：

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...

  • 图片格式支持 .jpg / .jpeg / .png
  • 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间
​
style_image
string

风格参考图

  • 支持传入图片 Base64 编码或图片 URL（确保可访问）
  • 注意：若您使用 Base64 方式，请不要在 Base64 编码字符串前添加任何前缀（如 data:image/png;base64,），直接传递 Base64 编码后的字符串即可。
  • 正确的 Base64 编码参数：

iVBORw0KGgoAAAANSUhEUgAAAAUA...

  • 错误的 Base64 编码参数（包含 data: 前缀）：

data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...

  • 图片格式支持 .jpg / .jpeg / .png
  • 图片文件大小不能超过 10MB，图片宽高尺寸不小于 300px，图片宽高比要在 1:2.5 ~ 2.5:1 之间
​
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

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

  • 通过enabled参数定义，具体格式如下：
​
callback_url
string

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

​
external_task_id
string

自定义任务ID。

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

响应

200 - application/json

任务已接受。

​
code
integer

错误码；具体定义见错误码

示例:

0

​
message
string

错误信息

示例:

"string"

​
request_id
string

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

示例:

"string"

​
data
object