Kling Image 4.0 图像生成
使用 Kling Image 4.0 文生图或参考图编辑, 支持 2K、4K 和 8K 单图输出
国内用户请注意: 中国大陆用户请使用 https://toapis.cn 作为接口地址 (Base URL).文档示例中的 https://toapis.com 请替换为 https://toapis.cn.
使用 kling-image-4.0 从文字生成图片, 或传入最多 10 张参考图进行编辑和合成. 每次请求异步生成一张图片, 支持 2K、4K 和 8K.
Authorizations
Authorizationstring请求头必填所有接口均需要使用 Bearer Token 进行认证
获取 API Key: 访问 API Key 管理页面 获取您的 API Key
使用时在请求头中添加:
Authorization: Bearer YOUR_API_KEYBody
使用 application/json 提交请求, 以下参数均放在请求体顶层.
modelstring请求体必填默认值: kling-image-4.0固定为 kling-image-4.0.
promptstring请求体必填描述要生成的画面或要对参考图做的修改. 填入非空文本.
resolutionstring请求体默认值: 2K分辨率档位为 2K, 4K 或 8K, 大小写均可.
aspect_ratiostring请求体默认值: auto输出宽高比. 使用 auto 时由模型决定. 固定比例支持 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9.
sizestring请求体aspect_ratio 的别名, 接受相同的比例值. 同时传入两个字段时, 值须一致.
ninteger请求体默认值: 1生成图片数量, 固定为 1. 可省略此字段. 传入时只接受整数 1.
image_urlsstring[]请求体最多 10 张参考图, 按数组顺序用 @image_1, @image_2 等在提示词中指定各张图的用途. 每项为服务可访问的 HTTP 或 HTTPS 图片 URL. 本地文件可先通过上传图片接口获取 URL.
参考图支持 JPG、JPEG 或 PNG, 每张最多 30 MB, 宽和高均至少 300 像素, 宽高比介于 2:5 和 5:2.
reference_imagesstring[]请求体image_urls 的别名, 任选一个字段传入.
callback_urlstring请求体可选的任务结束通知地址. 使用已配置的 Token 任务 Webhook 时, 保持默认地址的协议、主机和端口一致. 省略时使用该 Token 已启用的默认地址.
参数限制
此接口仅用于单张标准图片. 请省略可灵原生请求字段 contents, options, settings, result_type 和 series_amount.
查询任务
收到 id 后, 用同一个 API Key 查询图片任务. queued 和 in_progress 表示任务尚未结束. completed 时从 result.data[0].url 读取图片地址, failed 时查看 error.
curl "https://toapis.com/v1/images/generations/TASK_ID" \
-H "Authorization: Bearer $TOAPIS_API_KEY"计费
按请求计费, 费率随账号定价区域和分辨率档位变化. 宽高比和参考图数量不影响费率. 查看任务用量和实扣金额.
Response
idstring任务唯一标识符, 用于查询任务状态
objectstring对象类型, 固定为 generation.task
modelstring使用的模型名称
statusstring提交成功时为 queued.
progressinteger任务进度百分比(0-100)
created_atinteger任务创建时间戳(Unix 时间戳)
metadataobject任务元数据
result.data[].urlstring任务完成后返回的单张图片 URL.
执行示例前设置 TOAPIS_API_KEY 环境变量. 参考图示例中的 example.com 是占位地址, 请替换为可访问的图片 URL.
请求示例
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0",
"prompt": "一座红白相间的灯塔立在海边礁石上, 海雾刚刚散去, 清晨的侧光照亮浪花.",
"resolution": "2K",
"aspect_ratio": "16:9"
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "kling-image-4.0",
"prompt": "保留 @image_1 中台灯的外形和材质, 将它放进 @image_2 的书房场景, 让光线和阴影与原场景一致.",
"resolution": "4K",
"aspect_ratio": "4:3",
"image_urls": [
"https://example.com/lamp.png",
"https://example.com/study.jpg"
]
}'响应示例
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0",
"status": "queued",
"progress": 0,
"created_at": 1794960000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "kling-image-4.0",
"status": "completed",
"progress": 100,
"created_at": 1794960000,
"result": {
"type": "image",
"data": [
{
"url": "https://example.com/generated/kling-image-4.0.png"
}
]
}
}