任务：图像生成

概览

• 请求方法：POST
• 路径：/kling/v1/images/generations
• 内容类型：application/json

认证方式

• HTTP Bearer：Authorization: Bearer <token>

---

请求参数

Body 参数（JSON）

参数	类型	必填	描述
prompt	string	是	正向文本提示，不能超过500个字符
negative_prompt	string	否	负向文本提示，不能超过200个字符
image	string	否	参考图片（Base64或URL），支持 .jpg/.jpeg/.png，<=10MB，分辨率>=300x300
image_fidelity	number	否	图片参考强度，取值范围 [0,1]
n	integer	否	生成数量，取值范围 [1,9]
aspect_ratio	string	否	比例，枚举：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
callback_url	string	否	回调地址，异步通知任务结果
model_name	string	否	模型名称，枚举：kling-v1，kling-v1-5，kling-v2
image_reference	string	否	图片参考类型，枚举：subject, face（face时仅1张人脸）
human_fidelity	number	否	主体参考度，取值范围 [0,1]

注：使用 kling-v1-5 且 image 非空时，image_reference 必填。

---

示例请求

curl 示例

curl -X POST "https://api.gpt.ge/kling/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxx" \
  -d '{
    "prompt": "粉红色头发和蓝色头发的女孩，闪亮/光泽的风格，石林黄，浅蓝色和浅黑色，童话核心，青色，罗恩，柔和的阴影，动漫风格",
    "model_name": "kling-v1",
    "n": 1
  }'

JavaScript (fetch) 示例

fetch('https://api.gpt.ge/kling/v1/images/generations', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer sk-xxxx'
  },
  body: JSON.stringify({
    prompt: '粉红色头发和蓝色头发的女孩，闪亮/光泽的风格，石林黄，浅蓝色和浅黑色，童话核心，青色，罗恩，柔和的阴影，动漫风格',
    model_name: 'kling-v1',
    n: 1
  })
}).then(r => r.json()).then(console.log)

Python 示例（requests）

import requests

resp = requests.post(
    'https://api.gpt.ge/kling/v1/images/generations',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer sk-xxxx'
    },
    json={
        'prompt': '粉红色头发和蓝色头发的女孩，闪亮/光泽的风格，石林黄，浅蓝色和浅黑色，童话核心，青色，罗恩，柔和的阴影，动漫风格',
        'model_name': 'kling-v1',
        'n': 1
    }
)
print(resp.json())

---

返回字段

200 成功

字段	类型	描述
code	integer	返回码，0 表示成功
message	string	返回信息
request_id	string	请求唯一ID
data.task_id	string	任务ID
data.task_status	string	任务状态，如 submitted
data.created_at	integer	任务创建时间戳（毫秒）
data.updated_at	integer	任务更新时间戳（毫秒）

返回示例

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "CjNQtmctxFMAAAAAAHH7hA",
  "data": {
    "task_id": "CjNQtmctxFMAAAAAAHH7hA",
    "task_status": "submitted",
    "created_at": 1731252406651,
    "updated_at": 1731252406651
  }
}