Kling
多图参考生图
DeerAPI 多图参考生图接入说明：说明当前能力页与官方 multiImageToImage 的对应关系、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",
"prompt": "让同一只橘猫以两种角度出现在同一张写实海报里。",
"subject_image_list": [
{"subject_image": "https://example.com/cat-angle-1.png"},
{"subject_image": "https://example.com/cat-angle-2.png"}
],
"aspect_ratio": "16:9",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}/kling/v1/images/generations 在这条能力下更像“多参考图一致性生成”。当你关心的是人物、商品或道具在多张图片之间保持稳定，而不是从零发散创作时，优先选这页。
什么时候选多图参考生图
- 你有多张同一主体的参考图，想锁定脸、发型、服装或商品特征。
- 你要做同一角色的系列图，而不是单张海报。
- 你希望后面继续接视频工作流，让参考集合先在静态图阶段稳定下来。
最小输入组合
- 首个请求先保留
subject_image_list和prompt。 - 如果你需要固定模型版本，再补
model_name。 - 先让参考图之间的主体一致，再考虑场景或风格增强输入。
多图并不等于多主体。参考图之间的主体差异越大，结果越容易失焦或漂移。
第二轮再考虑的增强项
- 需要补充环境语义时，再加入场景类参考。
- 需要统一画风时，再加入风格类参考。
- 需要批量落库时，再加
callback_url和业务侧任务映射字段。
常见误解
- 只有一张参考图，却直接用多图参考页。
- 想扩现有图片的边界，却把问题交给多图一致性接口。
- 把 DeerAPI capability
kling_multi_image2image当成请求体model_name。
相关页面
图像生成
从零起稿或单图轻量参考时，通常还是先用基础图像生成页。
扩图
你已经有确定的主图，只需要扩边时不要改走多图生成。
多图参考生视频
静态一致性验证完成后，再继续进入视频工作流。
查询任务
这条能力仍按通用 Kling 图像任务方式查询。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Headers
Body
application/json
当前页面在 DeerAPI 文档中按能力单列展示；如果请求体里传 model_name，它仍然是官方 Kling 模型枚举，而不是 DeerAPI capability ID。
Kling 图像生成 API 请求体定义
参考主体图片列表,最少2张最多4张图片
Show child attributes
Show child attributes
模型名称
Available options:
kling-v2 正向文本提示词,不能超过2500个字符
场景参考图,支持图片URL或Base64编码(不带前缀),支持.jpg/jpeg/.png格式,文件大小不超过10MB,尺寸不小于300px,宽高比在1:2.5~2.5:1之间
风格参考图,支持图片URL或Base64编码(不带前缀),支持.jpg/jpeg/.png格式,文件大小不超过10MB,尺寸不小于300px,宽高比在1:2.5~2.5:1之间
生成图片数量
生成图片的画面纵横比(宽:高)
Available options:
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 本次任务结果回调通知地址,如果配置,服务端会在任务状态发生变更时主动通知
自定义任务ID,用户自定义任务ID,传入不会覆盖系统生成的任务ID,但支持通过该ID进行任务查询。单用户下需要保证唯一性
⌘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",
"prompt": "让同一只橘猫以两种角度出现在同一张写实海报里。",
"subject_image_list": [
{"subject_image": "https://example.com/cat-angle-1.png"},
{"subject_image": "https://example.com/cat-angle-2.png"}
],
"aspect_ratio": "16:9",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"created_at": 123,
"updated_at": 123
}
}