apimodels.app

GPT Image 2 All API reference

OpenAI 兼容的 GPT Image 2 同步图片 API —— OpenAI SDK / Codex / Cursor 改一行 base_url 即可直连。完整分辨率 × 质量矩阵(1K/2K/4K × low/medium/high/auto),文生图 + 多图编辑(最多 16 张参考图),同步返回、无需轮询。

模型页:GPT Image 2 All API —— 价格、规格与在线体验

认证

所有请求在 Header 携带 API Key:

Authorization: Bearer YOUR_API_KEY

价格(分辨率 × 质量)

字段	必填	类型	说明
档位	low	medium / auto	high
1K	$0.01	$0.025	$0.07
2K	$0.025	$0.03	$0.10
4K	$0.05	$0.05	$0.23

按张计费,quality=auto 按 medium 档收费;失败不扣费。生成速度随质量档变化:low 约 40 秒、medium 约 60-90 秒、high 约 2 分钟。

尺寸与计费档位

字段	必填	类型
计费档	典型 size	判定规则
1K	1024x1024 / 1536x1024 / 1024x1536	长边 ≤ 1536
2K	2048x2048 / 2048x1152 / 1152x2048	长边 1537-2048
4K	3840x2160 / 2160x3840	长边 > 2048

任意自定义 WxH 也支持:两边为 16 的倍数、最长边 ≤ 3840、长宽比 ≤ 3:1、总像素 65.5 万-829 万。也可以不传 size,改传 aspect_ratio + resolution(1K/2K/4K),由服务端算出最优尺寸。

输出尺寸:2K 和 4K

2K / 4K 档沿用 OpenAI 官方对 gpt-image-2 的尺寸口径。OpenAI 图像生成指南里列出的 2K / 4K 尺寸如下:

档位	尺寸	OpenAI 官方标注
2K	2048x2048	2K square
2K	2048x1152	2K landscape
4K	3840x2160	4K landscape
4K	2160x3840	4K portrait

计费档按你请求的 size 定,不按交付尺寸。像 2048x1152 这样的 2K 请求,可能正好交 2048x1152(OpenAI 标注的 2K 横图),也可能交同比例更大的 2736x1536,都按 2K 计费。
同一份指南写明,2560x1440 以上的分辨率属于实验性,所以 2736x1536 这类更大的尺寸不保证每次都有。
4K 受 OpenAI 的总像素上限 8,294,400(即 3840x2160)约束:16:9 和 9:16 的长边能到 3840,其他比例长边会短一些,比如 1:1 的 4K 是 2880x2880。

出处:OpenAI 图像生成指南 · GPT Image 2 settings

方式一:OpenAI SDK / Codex / Cursor(同步)

POST/api/v1/images/generations·POST/api/v1/images/edits

传 OpenAI 风格的 WxH size 即触发同步模式:请求直接返回图片(b64_json + url),与 OpenAI 官方 images.generate() / images.edit() 契约一致。

同步模式下，顶层 size 是我们实际交付的图片尺寸（2026-10-25 起），不再回显你请求的值；每个 data 项还带 width 和 height。图片量不出时，size 保持原来的行为。

# Text-to-image — OpenAI Images API shape, SYNC response (no task polling)
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-all",
    "prompt": "a white sneaker product shot on beige background, studio light",
    "size": "2048x2048",
    "quality": "medium",
    "n": 1
  }'
# → { "created": ..., "data": [{ "b64_json": "...", "url": "https://r2.apimodels.app/...", "width": 2048, "height": 2048 }], "size": "2048x2048" }

# Image edit / multi-image fusion — multipart, OpenAI images.edit() shape
curl -X POST https://api.apimodels.app/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2-all" \
  -F "image=@product.png" \
  -F "prompt=put this sneaker on a model, e-commerce close-up" \
  -F "size=2048x2048" \
  -F "quality=medium"

同步模式的等待与超时(2026-08-27 起)

同步请求最长等待 280 秒。等待超过约 95 秒仍未出图时,服务端会先发出 HTTP 200 响应头并每 15 秒写入一个空格保持连接,出图后再写入完整 JSON(前导空白是合法 JSON,所有解析器与 OpenAI SDK 均可直接处理)。这样 2K/4K high 这类 2–3 分钟的渲染不会再被网关以 524 中断。

代价:响应头发出后状态码不可再改。若任务在 95 秒之后才失败(例如上游内容审核在出图后拦截),响应仍为 HTTP 200,错误放在响应体 {"error": {"code": ..., "message": ..., "task_id": ...}} 中,不含 data 字段。请同时检查 error 字段,不要只看状态码。95 秒内的失败仍返回真实状态码:内容审核 400(code content_policy_violation)、参数错误 400、余额不足 402、上游忙 503、上游失败 502、超时 504。

每个同步响应都带 x-apimodels-task-id 响应头。若客户端在自己的超时内主动断开,可用它调用 GET /v1/images/generations?task_id=... 取回结果,任务不会因断开而取消或重复计费。

传 stream: true 可改用 OpenAI 图片流式契约(SSE):等待期间收到 ": processing Ns" 注释行,完成时收到 image_generation.completed / image_edit.completed 事件(含 b64_json 与 url),失败时收到 error 事件。这条路径没有上面的状态码限制,推荐给能改一行代码的调用方。预算超过 2 分钟的渲染也可直接使用方式二的异步契约。

方式二:原生异步(taskId + 轮询 / 回调)

不传 WxH size(或需要 callback_url)时走平台统一异步契约:创建返回 taskId,轮询到 completed 取结果,支持 webhook 回调。

# Native async contract — pass aspect_ratio + resolution tier instead of size.
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2-all",
    "prompt": "a lighthouse on a cliff at dusk",
    "aspect_ratio": "9:16",
    "resolution": "2K",
    "quality": "medium",
    "callback_url": "https://your-domain.com/webhook"
  }'
# → { "code": 200, "data": { "taskId": "..." } }

curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

参数

字段	必填	类型
字段	类型	说明
model	string	gpt-image-2-all
prompt	string	提示词(必填)
size	string	WxH,触发同步模式;见上方尺寸表
quality	string	low / medium / high / auto(默认 medium;auto 按 medium 计费)
aspect_ratio + resolution	string	异步模式下代替 size:比例 + 1K/2K/4K 档
image / image_base64 / image_url	string	参考图 → 自动走编辑端点
image_urls / images	string[]	多图融合,最多 16 张
mask / mask_url / mask_base64	string	不支持(2026-10-22 起):带 mask 的请求直接返回 400。局部修改请在提示词里点名要改的对象,例如「只把红色圆圈改成蓝色,其余保持不变」。
background	string	transparent / opaque / auto
output_format	string	png / jpeg / webp(可选)。不传时:不透明图交付 JPEG q95、带透明通道的图保持 PNG。传 png 得到无损原图,但体积约为 JPEG 的 6 倍(实测 1760x2352 成片:PNG 6.6MB vs JPEG 1.0MB);webp 体积与 JPEG 相当且支持透明。
response_format	string	b64_json(默认)或 url(仅 /images/edits)
stream	boolean	同步模式下改用 SSE 流式返回(见上方说明)
moderation	string	接受但忽略。内容过滤由上游模型侧固定执行,当前无法按请求或按账户放宽。
n	number	生成数量(计费 × n)

说明

与 gpt-image-2(异步 taskId 通道)底层同款模型;本通道主打 OpenAI 兼容 + 同步返回 + 完整质量矩阵。
上传大小:apimodels.app 入口单次请求体上限约 4.5MB(超出返回 413)。上传大图或多张参考图,请把 base_url 换成 https://api.apimodels.app/v1 —— 同一个 API、同一把 Key,单请求上限 100MB。
生成速度随质量档变化:low 约 40 秒、medium 约 60-90 秒、high 约 2 分钟。同步调用请把客户端超时设为 ≥180 秒。
生成失败不扣费。结果文件保留 30 天后自动删除,请及时下载或转存。

试一试:Playground

常见问题

GPT Image 2 支持几张参考图?

最多 16 张参考图(多图融合/编辑);超过 16 张只取前 16。用 images[] 传(或单张 image)。

GPT Image 2 支持哪些分辨率和价格?

原生 1K / 2K / 4K,按分辨率 × 质量计价:medium(默认)$0.025 / $0.03 / $0.05,low $0.01 / $0.025 / $0.05,high $0.07 / $0.10 / $0.23 每张。仅成功扣费。

本页涉及的模型

GPT Image 2 All · $0.01+