GPT Image API

最后更新:

给出 gpt-image-2 的图片生成请求、参考图编辑表单、比例分辨率与当前报价,检查 data 图片字段、实际宽高和客户端绘画入口。

生成与编辑使用两个接口

生成请求提交 JSON,编辑请求提交含参考图的 multipart 表单。下面展示 KK 的 gpt-image-2 合同;不要由 OpenAI 官方参数清单推定此路径支持所有可选功能。

项目当前合同
生成POST /v1/images/generations,JSON
编辑POST /v1/images/edits,multipart/form-data
比例与档位size: 16:9;resolution: 1k / 2k / 4k
返回图片检查 data[].url 或 data[].b64_json
当前报价1K: ¥1 · 2K: ¥1.5 · 4K: ¥2 / 10 次

最小请求示例

凭据从 KKAI_API_KEY 环境变量读取。示例是请求合同,运行后需核对实际响应和用量。

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
                base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
r = client.images.generate(
    model="gpt-image-2", prompt="微型数据中心插画,柔和自然光,无文字",
    size="16:9", extra_body={"resolution": "1k"},
)
image = r.data[0]
# 按实际字段保存;URL 应及时下载,base64 需解码。
print(image.url if image.url else image.b64_json)

用参考图编辑

只传图片与具体修改指令,multipart 的 Content-Type 边界由客户端生成。返回后核对文字、logo、产品轮廓与实际宽高;生成式编辑不能保证像素不变。

curl https://api.kkaiapi.com/v1/images/edits \
  -H "Authorization: Bearer $KKAI_API_KEY" \
  -F model="gpt-image-2" -F image="@product.png" \
  -F prompt="把背景改成浅灰影棚,尽量保留产品外观" \
  -F size="16:9" -F resolution="1k"

客户端入口与结果保存

聊天入口不等于绘画入口。Cherry Studio 等客户端必须能使用图片接口才可配置生图。保存 URL 时及时下载,base64 需解码;读取成片宽高并检查比例,不用裁切掩盖请求失败。视频则走独立异步任务接口。

常见问题

本页示例代表已经实测成功吗?

示例说明当前请求结构与配置方式。请在自己的运行环境核对响应、模型 ID 与用量;模型快照和文档不能替代一次真实业务验收。