Kling
图像生成
DeerAPI 图像生成接入说明：统一说明 Kling image generation 的 capability ID、model_name、查询方式与回调用法。
POST
/
kling
/
v1
/
images
/
generations
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/images/generations \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v2-new",
"prompt": "清晨的山谷里，一只白色狐狸停在薄雾中回头看向镜头。",
"n": 1,
"aspect_ratio": "16:9",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"data": {
"created_at": 123,
"task_id": "<string>",
"task_info": {
"external_task_id": null
},
"task_result": null,
"task_status": "<string>",
"task_status_msg": null,
"updated_at": 123
},
"message": "<string>"
}/kling/v1/images/generations 是 Kling 图像类任务的主入口。你只有文本，或者只有一张参考图需要辅助控制时，先用这页。
从零出图
当前页适合纯提示词起稿，或一张参考图做轻量控制。
锁定多图主体
需要多张人物或商品图来维持一致性时改走这页。
扩已有画布
已经有成图，只想把边界扩出去时不要再用文生图。
DeerAPI 的 capability 是
kling_image，而 model_name 仍然是官方 Kling 模型值。两者不要混用。最小可用调用
- 首个请求先保留
prompt。 - 需要固定画幅时再补
aspect_ratio。 - 需要一次返回多张图时再加
n。 - 只有在基础风格稳定后，再加入
image或image_fidelity这类参考控制。
什么时候不该选这页
常见误解
- 把多图一致性需求放到单图生成页里解决。
- 还没确认提示词方向，就先叠加太多参考控制。
- 忽略异步结果地址的时效性，产出后没有及时转存。
相关页面
- 多图参考生图：同一主体、多视角或多张商品图的一致性生成。
- 扩图：保持主体不变，只扩展画布边界。
- 查询任务：统一轮询 Kling 图像异步任务。
- Callback 协议：需要服务端主动通知时使用。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Headers
Body
application/json
请求体沿用官方 Kling 字段语义；其中 model_name 仍然是官方模型名，不是 DeerAPI live capability ID。
正向文本提示，必须，不能超过500个字符
负向文本提示，可选，不能超过200个字符
参考图片，可选，支持可访问的图片 URL 或原始 Base64 编码。若使用 Base64，请只传 <BASE64_IMAGE_DATA>，不要附带 data:image/...;base64, 前缀。图片格式支持 .jpg / .jpeg / .png，大小不超过 10MB，分辨率不小于 300x300。
生成过程中对用户上传图片的参考强度，可选，取值范围：[0,1]
生成图片数量，可选，取值范围：[1,9]
生成图片的纵横比，可选，枚举值：16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3
本次任务结果回调通知地址，可选
value: kling-v1,kling-v2,kling-v2-new
⌘I
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/images/generations \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v2-new",
"prompt": "清晨的山谷里，一只白色狐狸停在薄雾中回头看向镜头。",
"n": 1,
"aspect_ratio": "16:9",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"data": {
"created_at": 123,
"task_id": "<string>",
"task_info": {
"external_task_id": null
},
"task_result": null,
"task_status": "<string>",
"task_status_msg": null,
"updated_at": 123
},
"message": "<string>"
}