gpt-image-2 调用

gpt-image-2 是 OpenAI 图像生成与编辑模型，适合生成海报、电商图、产品配图、UI 视觉稿、文档封面和社交媒体素材。通过 kukuai.fyi 可使用 OpenAI 兼容的 Images API 接入。

基础信息

项目	值
Base URL	https://www.kukuai.fyi/api-proxy/china/v1
文生图 Endpoint	POST /images/generations
图片编辑 Endpoint	POST /images/edits
Model ID	gpt-image-2
鉴权	Authorization: Bearer <KUKUAI_API_KEY>

如果你只需要从文字生成图片，使用 /images/generations。如果需要上传参考图、局部重绘或多图合成，使用 /images/edits。

文生图

最小请求只需要传入 model 和 prompt。建议先用 1024x1024、n=1 验证风格；生产任务优先使用 1K 或 2K 稳定尺寸，4K 尺寸按实验性能力处理。

export KUKUAI_API_KEY="YOUR_KUKUAI_API_KEY"
export BASE_URL="https://www.kukuai.fyi/api-proxy/china/v1"

curl -s "$BASE_URL/images/generations" \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一张适合 API 文档站首页使用的科技风封面图，深色背景，清晰层次，发光网格线条，留出标题区域，无文字，无水印",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }' > response.json

保存返回图片

图像接口通常返回 data[0].b64_json。可以用 jq 和 base64 保存为 PNG。

mkdir -p output/images
jq -r '.data[0].b64_json' response.json | base64 -d > output/images/gpt-image-2.png

如果响应里返回的是 url，则直接读取 URL：

jq -r '.data[0].url' response.json

图片编辑

图片编辑使用 multipart/form-data 上传图片。适合保留主体、替换背景、统一风格、把草图转成成品图，或把多张素材组合成一张图。

export KUKUAI_API_KEY="YOUR_KUKUAI_API_KEY"
export BASE_URL="https://www.kukuai.fyi/api-proxy/china/v1"

curl -s "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@reference.png" \
  -F "prompt=保留参考图主体和比例，将背景改成干净的科技产品发布会舞台，冷色灯光，高级商业摄影质感，无文字，无水印" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "n=1" > edit-response.json

多图参考时继续追加 image[]：

curl -s "$BASE_URL/images/edits" \
  -H "Authorization: Bearer $KUKUAI_API_KEY" \
  -F "model=gpt-image-2" \
  -F "image[]=@product.png" \
  -F "image[]=@background-style.png" \
  -F "prompt=使用第一张图的产品主体，参考第二张图的灯光和背景风格，生成一张电商主图，无文字，无水印" \
  -F "size=1024x1024" > edit-response.json

尺寸与稳定性

gpt-image-2 建议按尺寸分级选择 size。生产环境优先使用 1K 和 2K 稳定区间；大于 2560x1440 的尺寸建议标记为实验性能力，先做小批量验证再接入正式链路。

1K 稳定尺寸

1K 是默认推荐档，适合生产调用、草图确认、头像、封面缩略图和普通配图。

尺寸	画幅	建议用途
1024x1024	方形	默认方形图、头像、图标、通用封面。
1536x1024	横版	横版海报、网站首屏、文章头图、产品横幅。
1024x1536	竖版	移动端海报、竖版商品图、社媒竖图。

2K 稳定上限

2K 是更清晰的生产档，适合对细节要求更高的海报、电商主图和网页视觉素材。

尺寸	画幅	建议用途
2048x2048	方形 2K	高清方图、商品主图、可裁切封面。
2560x1440	16:9 QHD	横版大图、网页首屏、视频封面；这是建议的安全边界。

2560x1440 及以下属于稳定可用区间。超过该边界时，建议在业务代码、后台配置或文档中标注为实验性尺寸。

4K 实验尺寸

4K 适合少量高分辨率测试、展示图或后期处理素材。由于尺寸超过稳定区间，可能出现耗时更长、失败率更高、成本更高或上游策略调整。

尺寸	画幅	状态
3840x2160	4K 16:9	Experimental
2160x3840	4K 9:16	Experimental

生产系统如果开放 4K，建议在前端加上“实验性”标识，并在失败时自动降级到 2560x1440 或对应的 1K/2K 画幅。

常用参数

字段	类型	必填	说明
model	string	必填	固定为 gpt-image-2。
prompt	string	必填	图片生成或编辑指令。写清主体、场景、构图、风格、比例和限制。
image[]	file	编辑必填	/images/edits 上传的参考图，可传一张或多张。
size	string	可选	输出尺寸。生产推荐 1024x1024、1536x1024、1024x1536、2048x2048、2560x1440；大于 2560x1440 的尺寸按实验性处理。
quality	string	可选	常用 low、medium、high。质量越高，成本和耗时通常越高。
n	integer	可选	生成数量。批量生成前建议先单张确认提示词。
output_format	string	可选	常用 png、jpeg、webp，以当前接口支持为准。

Prompt 模板

文档封面

为 kukuai.fyi API 文档站生成一张首页封面背景图。深色科技风，抽象数据流和发光节点，构图简洁，左侧留出标题区域，适合网页首屏，无文字，无 logo，无水印。

电商主图

生成一张高级电商产品主图，主体居中，柔和棚拍灯光，干净背景，真实摄影质感，边缘清晰，适合移动端商品详情页，无文字，无水印。

UI 视觉稿

生成一张现代 SaaS 数据看板视觉稿，真实屏幕截图质感，清晰信息层级，浅色界面，图表和列表布局自然，适合产品官网展示，无品牌文字，无水印。

排错

问题	处理方式
401 Unauthorized	检查 KUKUAI_API_KEY 是否存在、是否复制完整，以及账户余额是否可用。
404 Not Found	确认 Base URL 为 /api-proxy/china/v1，Endpoint 为 /images/generations 或 /images/edits，模型名为 gpt-image-2。
返回空图片	先查看完整 response.json，确认是否返回错误体，不要直接解码空字符串。
jq: command not found	安装 jq，或改用 Node.js / Python 解析 JSON。
base64 -d 失败	macOS 可尝试 base64 -D。
图片不符合预期	在 prompt 中明确主体、构图、风格、用途、尺寸、禁止文字和禁止水印。
4K 请求不稳定	将 3840x2160 或 2160x3840 降级到 2560x1440、2048x2048 或对应 1K 画幅后重试。

相关页面

• gpt-image-2 模型页
• gpt-image-2-2k 模型页
• gpt-image-2-4k 模型页
• Google 图片生成