ToAPIsToAPIs
Kling Image 4.0

Kling Image 4.0 图像生成

使用 Kling Image 4.0 文生图或参考图编辑, 支持 2K、4K 和 8K 单图输出

POST
/v1/images/generations

国内用户请注意: 中国大陆用户请使用 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_KEY

Body

使用 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"
      }
    ]
  }
}