GPT Image 2
用 GPT Image 2 出图
本教程里说的 GPT Image 2，只负责生图，不生视频，也不能填进 Codex 当聊天模型。网页入口是 在线生图；自己写客户端时走 Images API。视频请看 Grok 生图 / 生视频。
把 llm.txt 粘贴给你的 Codex / GPT，它就能按本站接口写客户端，不必再从网页里摘字段。
开始前
1K 必须选 GPT Image 2 - 1K；2K / 4K 必须选 GPT Image 2 - 2K4K。OpenAI 对话分组、Grok（Heavy）都不能打这套接口。价格以控制台和 模型价格 为准。
提示
长请求走直连域名。image-direct.geiliapi.com 不过 Cloudflare，超时 600 秒。高峰期出图可能超过 CF 约 125 秒的限制；对话、拉模型、管密钥仍用 sub.geiliapi.com。
先选对分组
| 你要做的事 | 创建 Key 时选 | 去哪里 |
|---|---|---|
| GPT Image 2 · 1K | GPT Image 2 - 1K | 本页 + 在线生图 |
| GPT Image 2 · 2K / 4K | GPT Image 2 - 2K4K | 同一在线生图页，规格选 2K 或 4K |
| Grok 生图 / 生视频 | Grok（Heavy） | Grok 生图 / 生视频 |
| Codex / 对话 | OpenAI 分组 | Codex |
网页最快路径
- 1
按规格创建密钥
控制台「API 密钥」→ 创建密钥。只要 1K，选
GPT Image 2 - 1K；要 2K 或 4K，再单独建一把GPT Image 2 - 2K4K。两把可以同时存在。创建后只显示一次完整 Key，先复制保存。 - 2
打开在线生图
侧栏点「在线生图」，或直接打开 /image-studio/。已登录时页面会按分组自动分拣到标准密钥和高清密钥。
- 3
确认引擎是 GPT Image
顶部引擎默认就是 GPT Image。没有对应分组密钥时，该规格会锁定，点进去会引导去创建，不会等到点「开始生成」才报错。
- 4
选规格、尺寸再生成
文生图或图生图。1K / 2K / 4K 决定画质和计费；尺寸随规格变化。图生图必须先上传参考图，最多 4 张，也可选自动尺寸跟随参考图比例。
- 5
到使用记录核对
生成完成后，控制台「使用记录」应出现对应的 1K 或 2K4K 密钥和
gpt-image-2。这才算真正打到本站。
规格、quality 和尺寸
API 里用 quality 定档、size 定比例。只使用下表白名单；4096x4096 不可用（上游最长边不超过 3840，总像素不超过 8,294,400）。
| 规格 | quality | 密钥分组 | 可用 size |
|---|---|---|---|
| 1K 标准 | low | GPT Image 2 - 1K | 1024x1024 方图 · 1536x1024 横图 3:2 · 1024x1536 竖图 2:3 |
| 2K 高清 | medium | GPT Image 2 - 2K4K | 2048x2048 方图 · 2048x1152 横图 16:9 · 1152x2048 竖图 9:16 |
| 4K 超清 | high | GPT Image 2 - 2K4K | 2880x2880 方图 · 3840x2160 横图 UHD · 2160x3840 竖图 UHD |
图生图还可以传 size=auto，输出跟随参考图比例。模型默认 gpt-image-2；页面也接受 gpt-image-1.5、gpt-image-1，以控制台实际可用为准。
API：文生图
必须同时带对的分组 Key、quality 和白名单 size。1K 用 1K Key 且 quality=low；2K / 4K 用 2K4K Key。
read -s GEILI_GPT_IMAGE_1K_KEY
curl -sS https://image-direct.geiliapi.com/v1/images/generations \
-H "Authorization: Bearer $GEILI_GPT_IMAGE_1K_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"一张电影感产品照片，干净摄影棚背景，柔和自然光，高细节","quality":"low","size":"1024x1024","n":1}'
unset GEILI_GPT_IMAGE_1K_KEY$secure = Read-Host "GPT Image 1K API Key" -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secure)
$key = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr)
Invoke-RestMethod https://image-direct.geiliapi.com/v1/images/generations -Headers @{Authorization="Bearer $key"} -ContentType "application/json" -Body '{"model":"gpt-image-2","prompt":"一张电影感产品照片，干净摄影棚背景，柔和自然光，高细节","quality":"low","size":"1024x1024","n":1}'
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr)2K 示例把 Key 换成 2K4K 分组，并把 quality 改成 medium、size 改成 2048x2048。4K 用同一把 2K4K Key，quality=high，size 用 2880x2880 / 3840x2160 / 2160x3840。
API：图生图
用 multipart 上传参考图。字段名第一张是 image，更多参考图用 image[1]、image[2]，最多 4 张。
curl -sS https://image-direct.geiliapi.com/v1/images/edits \
-H "Authorization: Bearer $GEILI_GPT_IMAGE_1K_KEY" \
-F model=gpt-image-2 \
-F prompt="保持主体，把背景换成清晨的厨房" \
-F quality=low \
-F size=1024x1024 \
-F image=@./reference.png验证第一次请求
- 1
确认 Key 分组
控制台密钥列表的分组名应是
GPT Image 2 - 1K或GPT Image 2 - 2K4K。OpenAI / Codex Key、普通 Grok Key、Grok（Heavy）Key 调这套接口会 401、404 或提示平台不支持。 - 2
网页先跑一张
在线生图保持 GPT Image → 文生图 → 选已解锁的规格 → 输入短提示词生成。成功后「使用记录」出现
gpt-image-2。 - 3
API 先打匿名边界
不带 Key 访问
https://image-direct.geiliapi.com/v1/images/generations应返回 401。再带对应分组 Key 发上面的最小请求。
这个工具的故障
1K 或 2K / 4K 规格是锁定的
当前登录账号缺少对应分组密钥。只要 1K，去控制台创建 GPT Image 2 - 1K；要 2K / 4K，再创建 GPT Image 2 - 2K4K。也可在密钥设置里手动粘贴后刷新。
401 / 分组不对
你很可能用了 Codex 的 OpenAI 分组 Key，或 Grok / Grok（Heavy）Key。1K 请求必须用 1K 分组；2K / 4K 必须用 2K4K 分组，不能交叉。
invalid image size / 所选尺寸不被上游支持
只使用本页白名单。4K 方图是 2880x2880，不是 4096x4096。1K 横竖图是 3:2 / 2:3，不是 16:9。
想要 256x256 / 512x512 做表情包
官方模型不能直接生成这么小的图（低于 gpt-image-2 的像素下限）。在线生图仍按 1K 生成、按 1K 计费，然后在结果区「导出尺寸」选 512 px 或 256 px，下载时浏览器等比缩到该边长，文件名带 -512px / -256px。走 API 的话请在自己代码里缩图。
请求在大约两分钟后变成 524
你打到了 sub.geiliapi.com，被 Cloudflare 空闲超时掐断。生图改走 https://image-direct.geiliapi.com/v1。
内容未通过安全策略
调整提示词或参考图后重试。这是上游安全策略，不是密钥或尺寸写错。
Codex 里填 gpt-image-2 没用
Codex 走 Responses 对话，不负责出图。回到在线生图，或按本页 Images API 接入。