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 与用量;模型快照和文档不能替代一次真实业务验收。