图像生成
POST
/kling/v1/images/generations
根据文本提示词与可选参考图创建图像生成任务。
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
model_name
string
Required
模型名称 枚举值:kling-v1, kling-v1-5, kling-v2, kling-v2-new, kling-v2-1,kling-v3
prompt
string
Required
正向文本提示词 不能超过2500个字符
negative_prompt
string
负向文本提示词 不能超过2500个字符
image
string
参考图像支持传入图片Base64编码或图片URL(确保可访问)
image_reference
string
图片参考类型
枚举值:subject(角色特征参考), face(人物长相参考)
使用face(人物长相参考)时,上传图片需仅含1张人脸。
使用 kling-v1-5 且 image 参数不为空时,当前参数必填
image_fidelity
number
生成过程中对用户上传图片的参考强度
取值范围:[0,1],数值越大参考强度越大
human_fidelity
number
面部参考强度,即参考图中人物五官相似度
仅 image_reference 参数为 subject 时生效
取值范围:[0,1],数值越大参考强度越大
resolution
string
生成图片的清晰度
枚举值:1k, 2k
1k:1K标清
2k:2K高清
n
integer
Required
生成图片数量
取值范围:[1,9]
aspect_ratio
string
生成图片的画面纵横比(宽:高)
枚举值:16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9
callback_url
string
任务完成回调地址
Responses
OK
application/json
object
task_id
string
任务 ID
task_status
string
任务状态