可灵 Kling 文生图/图生图 API 文档

推荐看官方文档

所有格式和参数都和官方文档一致。 仅在调用path前加上/kling。 我们更新不及时，建议直接查看官方文档

https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice

概念介绍

Kling 是一个多模态 AI 生成模型，支持：

• 文生图：根据文本提示生成图像
• 图生图：基于参考图生成新图像
• 混合生成：结合文本和图像输入生成图像

接口地址

POST https://www.dmxapi.cn/kling/v1/images/generations

请求参数

参数	类型	必选	说明
prompt	string	是	正向提示词(≤500字符)
negative_prompt	string	否	反向提示词(≤200字符)，图生图时无效
aspect_ratio	string	否	画面比例，可选：3:2, 16:9, 2:3, 3:4, 4:3, 9:16
image	string	否	参考图(Base64/URL)，支持jpg/png(≤10MB)
image_fidelity	number	否	参考图相似度(0-100)
human_fidelity	number	否	人物相似度(0-100)
image_reference	string	否	参考类型：face(人脸)/subject(主体特征)
model_name	string	否	模型版本：kling-v1/kling-v1-5
n	integer	否	生成数量(默认1)
callback_url	string	否	结果回调地址

Python 示例

import json

import requests

url = "https://www.dmxapi.cn/kling/v1/images/generations"
api_key = "sk-******************************************"  # 换成你的 DMXAPI 令牌


payload = json.dumps(
    {
        "model_name": "kling-v1",  # 模型名称
        "prompt": "画一只可爱小狗，背景广告牌写着 DMXAPI",  # 提示词
        "negative_prompt": "不要有城市建筑",  # 反面提示词
        "aspect_ratio": "1:1",  # 图像宽高比
        # "human_fidelity": 58,  # 人类相似度
        # "image": "https://dmxapi.cn/img/doc.png",  # 参考图
        # "image_fidelity": 40,  # 参考图相似度
        "n": 1,  # 生成数量
        # "callback_url": "https://linear-siege.name/",  # 回调地址
    }
)

headers = {"Content-Type": "application/json", "Authorization": f"Bearer {api_key}"}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

响应示例

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "ac9ba366-ef56-4ae6-8b86-8f5a29979ecf",
  "data": {
    "task_id": "785021218012401725",
    "task_status": "submitted",
    "created_at": 1755192162148,
    "updated_at": 1755192162148
  }
}

注意事项

1. 图生图时参考图需满足：
   • 分辨率 ≥300×300px
   • 宽高比在1:2.5~2.5:1之间
2. 使用人脸参考(image_reference=face)时：
   • 图片必须包含且仅包含1张人脸
   • 仅kling-v1-5模型支持
3. 生成结果可通过回调或任务ID查询获取

官方文档

https://app.klingai.com/cn/dev/document-api/apiReference/updateNotice