可灵AI 图像生成 API 文档

各模型支持的参数

Kling 系列模型

Kling 系列模型目前支持 Kling-V1、Kling-V1.5、Kling-V2、Kling-V2-new、Kling-V2.1

Input 参数

参数名	类型	必填	说明	取值范围/格式
`prompt`	string	是	正向文本提示词，描述要生成的图像内容	非空字符串，不能超过 2500 个字符
`negative_prompt`	string	否	负向文本提示词，描述不希望出现在图像中的内容	字符串，不能超过 2500 个字符。注：图生图（即 `image` 字段不为空时）场景下，不支持负向提示词
`image`	string/array	否	参考图像，用于图生图。支持字符串格式（单张图像）或数组格式（多张图像）	支持 URL（`http://` 或 `https://`）或 Base64 编码（带 `data:image/{format};base64,` 前缀或不带前缀，支持 PNG、JPEG、JPG 等格式）。图片格式支持 `.jpg` / `.jpeg` / `.png`。图片文件大小不能超过 10 MB，图片宽高尺寸不小于 300 px，图片宽高比介于 1:2.5 ~ 2.5:1 之间。`image_reference` 参数不为空时，当前参数必填。数组格式示例：`["url1", "url2"]` 或 `["base64_1", "base64_2"]`

ExtraBody 参数

参数名	类型	必填	说明	默认值	取值范围/格式
`image_reference`	string	否	图片参考类型	-	枚举值：`subject`（角色特征参考）、`face`（人物长相参考）。使用 `face` 时，上传图片需仅含 1 张人脸。使用 `Kling-V1.5` 且 `image` 参数不为空时，当前参数必填。仅 `Kling-V1.5` 支持当前参数
`image_fidelity`	float	否	生成过程中对用户上传图片的参考强度	`0.5`	取值范围：[0,1]，数值越大参考强度越大
`human_fidelity`	float	否	面部参考强度，即参考图中人物五官相似度	`0.45`	取值范围：[0,1]，数值越大参考强度越大。仅 `image_reference` 参数为 `subject` 时生效
`resolution`	string	否	生成图片的清晰度	`1k`	枚举值：`1k`（1K 标清）、`2k`（2K 高清）。不同模型版本支持范围不同，详见能力地图
`n`	integer	否	生成图片数量	`1`	取值范围：[1,9]
`aspect_ratio`	string	否	生成图片的画面纵横比（宽:高）	`16:9`	枚举值：`16:9`、`9:16`、`1:1`、`4:3`、`3:4`、`3:2`、`2:3`、`21:9`。不同模型版本支持的范围不同，详见能力地图
`callback_url`	string	否	本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知	-	有效的 URL 地址。具体通知的消息 schema 见"Callback 协议"
`provider`	object	否	调度配置参数	-	对象类型，包含图像生成特有参数和供应商调度参数。图像生成特有参数： - `enable_image_base64` (bool, 默认 `false`): 是否在响应数据的 `data` 字段中同时返回图像的 `Base64` 编码 - `enable_image_origin_data` (bool, 默认 `false`): 是否在响应中包含原始响应数据供应商调度参数：还支持 `only`、`order`、`sort`、`input_price_range`、`output_price_range`、`throughput_range`、`latency_range`、`input_length_range`、`allow_filter_prompt_length`、`ignore`、`allow_fallbacks` 等参数。详细说明请参考：供应商调度参数说明

请求示例

文生图示例：

json

{
  "model": "Kling-V2.1",
  "input": {
    "prompt": "a beautiful sunset over the ocean with vibrant colors",
    "negative_prompt": "low quality, blurry"
  },
  "extra_body": {
    "provider": {
      "enable_image_base64": false,
      "enable_image_origin_data": true
    },
    "resolution": "2k",
    "n": 1,
    "aspect_ratio": "16:9"
  }
}

图生图示例：

json

{
  "model": "Kling-V2.1",
  "input": {
    "prompt": "make the sky more colorful and add some clouds",
    "image": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
  },
  "extra_body": {
    "provider": {
      "enable_image_base64": false,
      "enable_image_origin_data": true
    },
    "image_reference": "subject",
    "image_fidelity": 0.6,
    "human_fidelity": 0.5,
    "resolution": "2k",
    "n": 1,
    "aspect_ratio": "16:9"
  }
}

响应示例

所有模型都返回标准化的响应格式，示例如下：

json

{
  "created": 1736123456,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg",
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."  // 可选字段
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": {
      "text_tokens": 0,
      "image_tokens": 0
    },
    "image_count": 2
  },
  "provider": "可灵AI",
  "model": "Kling-V1",
  "origin_data": { ... }  // 可选字段
}

说明：

data[].b64_json 字段：仅在 extra_body.provider.enable_image_base64 设置为 true 时返回。默认值为 false，此时响应中不包含 b64_json 字段
origin_data 字段：包含供应商 API 的完整原始响应数据。可通过设置 extra_body.provider.enable_image_origin_data 参数控制是否返回此字段（默认值为 false，不会返回）。如需查看不同模型的原始响应格式，请在请求中设置 extra_body.provider.enable_image_origin_data: true，然后在响应的 origin_data 字段中查看供应商返回的原始数据

响应参数说明

成功响应

参数名	类型	必填	说明	取值范围/格式
`created`	integer	是	响应创建时间，`Unix` 时间戳（秒）	整数，`Unix` 时间戳（秒）
`data`	array	是	生成的图像数据数组	数组对象，每个元素包含图像信息
`data[].url`	string	是	生成的图像 URL	URL 字符串
`data[].b64_json`	string	否	图像的 `Base64` 编码数据。控制参数：仅在请求参数 `extra_body.provider.enable_image_base64` 设置为 `true` 时返回此字段。默认值为 `false`，此时不返回此字段	`Base64` 编码的字符串
`usage`	object	是	使用情况统计	对象类型
`usage.total_tokens`	integer	是	总 `token` 数	整数，图像生成场景通常为 0
`usage.input_tokens`	integer	是	输入 `token` 数	整数，图像生成场景通常为 0
`usage.output_tokens`	integer	是	输出 `token` 数	整数，图像生成场景通常为 0
`usage.input_tokens_details`	object	是	输入 `token` 详情	对象类型
`usage.input_tokens_details.text_tokens`	integer	是	文本 `token` 数	整数，图像生成场景通常为 0
`usage.input_tokens_details.image_tokens`	integer	是	图像 `token` 数	整数，图像生成场景通常为 0
`usage.image_count`	integer	是	生成的图像数量	整数，大于等于 1
`provider`	string	是	供应商名称	字符串，如"可灵AI"
`model`	string	是	模型名称	字符串，如 `Kling-V1`
`origin_data`	object	否	供应商的原始响应数据。控制参数：仅在请求参数 `extra_body.provider.enable_image_origin_data` 设置为 `true` 时返回此字段。默认值为 `false`，此时不返回此字段	对象类型，包含供应商 API 的完整原始响应

错误响应

当 API 调用失败时，会返回供应商的原始错误信息。

错误响应格式:

如果响应是 JSON 格式，返回完整的错误 JSON 对象
如果响应是文本格式，返回错误文本
如果无法解析，返回 HTTP {status_code}

错误响应示例:

json

{
  "code": 400,
  "message": "Invalid parameter: prompt cannot be empty",
  "request_id": "req_1234567890"
}

注意事项

模型参数限制：不同模型版本支持的参数不同。对于不在白名单中的参数，系统会记录警告日志，但不会过滤，仍会传递给供应商 API 进行最终判断
参数透传：所有参数（包括 model_name、resolution、aspect_ratio、image_fidelity 等）都会透传给供应商 API，由供应商进行校验和判断
模型版本兼容性:
- 不同模型版本支持的能力不同，详见能力地图
图生图限制:
- 使用 Kling-V1.5 且 image 参数不为空时，image_reference 参数必填
Base64 编码注意事项:
- 请确保传递的所有图像数据参数均采用 Base64 编码格式
- 在提交数据时，不要在 Base64 编码字符串前添加任何前缀（如 data:image/{format};base64,）
- 正确的参数格式应该直接是 Base64 编码后的字符串
未知参数处理：未知参数会被记录警告日志，但仍会传递给供应商 API，由供应商判断是否返回错误
供应商调度参数：关于 extra_body.provider 参数的完整说明和使用示例，请参考供应商调度参数说明

可灵AI 图像生成 API 文档 ​

各模型支持的参数 ​

Kling 系列模型 ​

Input 参数 ​

ExtraBody 参数 ​

请求示例 ​

响应示例 ​

响应参数说明 ​

成功响应 ​

错误响应 ​

注意事项 ​

可灵AI 图像生成 API 文档

各模型支持的参数

Kling 系列模型

Input 参数

ExtraBody 参数

请求示例

响应示例

响应参数说明

成功响应

错误响应

注意事项