图像生成

POSThttps://www.aipro2.com/kling/v1/images/generations

根据文本提示词生成图像。

请求体参数

application/json

• aspect_ratiostring
  生成图片的画面纵横比（宽:高）
  枚举值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9
• callback_urlstring
• human_fidelitynumber
  面部参考强度，即参考图中人物五官相似度
  仅 image_reference 参数为 subject 时生效
  取值范围：[0,1]，数值越大参考强度越大
• imagestring
  参考图像支持传入图片Base64编码或图片URL（确保可访问）
• image_fidelitynumber
  生成过程中对用户上传图片的参考强度
  取值范围：[0,1]，数值越大参考强度越大
• image_referencestring
  图片参考类型
  枚举值：subject（角色特征参考）, face（人物长相参考）
  使用face（人物长相参考）时，上传图片需仅含1张人脸。
  使用 kling-v1-5 且 image 参数不为空时，当前参数必填
• model_name*string
  模型名称 枚举值：kling-v1, kling-v1-5, kling-v2, kling-v2-new, kling-v2-1,kling-v3
• n*integer
  生成图片数量
  取值范围：[1,9]
• negative_promptstring
  负向文本提示词 不能超过2500个字符
• prompt*string
  正向文本提示词 不能超过2500个字符
• resolutionstring
  生成图片的清晰度
  枚举值：1k, 2k
  1k：1K标清
  2k：2K高清

响应

任务提交成功

application/jsonKlingTaskSubmitResponse

• codeinteger
  业务状态码

  示例0
• dataobject
  数据载荷（常为 Base64 或结构化对象）
• messagestring
  提示信息

  示例success
• request_idstring
  请求追踪 ID

请求体示例示例 1

1{
2    "model_name": "kling-v1",
3    "prompt": "生成一张海边的图",
4    "negative_prompt": "",
5    "image": "",
6    "image_reference": "",
7    // "image_fidelity": "0.5",
8    "human_fidelity": 0.45,
9    "resolution": "1k",
10    "n": 2,
11    "aspect_ratio": "16:9",
12    "callback_url": ""
13}

代码示例cURLPythonJavaScriptGoPHP

1curl -X POST "https://www.aipro2.com/kling/v1/images/generations" \2  -H "Authorization: Bearer <API Key>" \3  -H "Content-Type: application/json" \4  -d '"{\r\n    \"model_name\": \"kling-v1\",\r\n    \"prompt\": \"生成一张海边的图\",\r\n    \"negative_prompt\": \"\",\r\n    \"image\": \"\",\r\n    \"image_reference\": \"\",\r\n    // \"image_fidelity\": \"0.5\",\r\n    \"human_fidelity\": 0.45,\r\n    \"resolution\": \"1k\",\r\n    \"n\": 2,\r\n    \"aspect_ratio\": \"16:9\",\r\n    \"callback_url\": \"\"\r\n}"'

响应示例 · 200example

1{2  "code": 0,3  "data": {4    "created_at": 0,5    "task_id": "string",6    "task_status": "submitted",7    "updated_at": 08  },9  "message": "success",10  "request_id": "string"11}