POST/kling/v1/images/generations

图像生成

API Key application/json

Request

请求

/kling/v1/images/generations

Body

必填

Bodyobject

model_namestring必填

模型名称枚举值：kling-v1, kling-v1-5, kling-v2, kling-v2-new, kling-v2-1,kling-v3

示例kling-v1

promptstring必填

正向文本提示词不能超过2500个字符

示例生成一张海边的图

negative_promptstring

负向文本提示词不能超过2500个字符

imagestring

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

image_referencestring

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

image_fidelitynumber

生成过程中对用户上传图片的参考强度取值范围：[0,1]，数值越大参考强度越大

human_fidelitynumber

面部参考强度，即参考图中人物五官相似度仅 image_reference 参数为 subject 时生效取值范围：[0,1]，数值越大参考强度越大

resolutionstring

生成图片的清晰度枚举值：1k, 2k 1k：1K标清 2k：2K高清

ninteger必填

生成图片数量取值范围：[1,9]

aspect_ratiostring

生成图片的画面纵横比（宽:高）枚举值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9

callback_urlstring

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	否	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/kling/v1/images/generations \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model_name": "kling-v1",
    "prompt": "生成一张海边的图",
    "negative_prompt": "",
    "image": "",
    "image_reference": "",
    // "image_fidelity": "0.5",
    "human_fidelity": 0.45,
    "resolution": "1k",
    "n": 2,
    "aspect_ratio": "16:9",
    "callback_url": ""
}'

Response

返回响应 `200`

HTTP 响应

响应 200object