GPT Image 2.5 API ： 生成最高 4K、可带透明背景的 AI 图片
在这里直接在线试用 GPT Image 2.5：写一段提示词，最多加 16 张参考图，选好画质、分辨率和比例，一次最多出 4 张图。满意之后，用一个 API Key、一份余额，通过 GPT Image 2.5 API 在你自己的产品里调用同一个模型。
- 最多 16 张参考图
- 五档质量
- 按张计费
- 开放 GPT Image 2.5 API
功能亮点
GPT Image 2.5 API 的核心能力
文生图，也能用参考图
提示词最长 8000 字符，用来描述你要的画面；也可以加最多 16 张参考图，在提示词里用 @Image1、@Image2… 点名每一张。不传 image_urls 就是纯文生图，传了就能做到比如把 @Image1 里的商品放到大理石桌面上。
五档画质
quality 从 low 开始，依次是 medium、high、xhigh 和 max。画质和分辨率一起决定每张单价，可以先用 low 打草稿，定稿时再换成需要的档位。
透明背景
把 background 设成 transparent，GPT Image 2.5 返回透明背景的 PNG，带不带参考图都可以，直接用作 Logo、贴纸、图标和商品抠图。必须用这个参数：只在提示词里写透明背景，模型会把棋盘格画进不透明的图里。不影响价格。
两个版本：Flare 和 Sunburst
每个任务可以选 variant flare 或 sunburst，价格相同。Flare 速度快，适合日常创作和批量出图；Sunburst 细节更精准，适合精修和高质量成片，生成稍慢。
1k 到 4k，15 种比例
分辨率可选 1k、2k、4k，比例可选 1:1、3:2、2:3、4:3、3:4、4:5、5:4、16:9、9:16、21:9、27:16、16:27、9:8、8:9，也可以用 auto 跟随第一张参考图（没有参考图时按 1:1）。
一次最多 4 张
num_outputs 可以设成 1–4。多张并行生成，4 张的耗时和 1 张差不多；low 画质、1k 分辨率一张约 15 秒。
简介
什么是 GPT Image 2.5？
- 模型 ID
gpt-image-2.5- 分辨率
- 1k / 2k / 4k
- 质量
- 低 / 中 / 高 / 很高 / 最高
- 画面比例
- 15 种
- 参考图
- 最多 16 张
- 每次张数
- 1–4 张
- 提示词
- 最长 8000 字符
- 价格
- 每张 $0.0117 起
GPT Image 2.5 是一个 AI 图片模型：用提示词生成图片，可以再加参考图，画质档位由你选，还可以出透明背景。提示词最长 8000 字符，能用 @Image1、@Image2… 点名每张参考图，一次请求就能说清哪个商品、哪个角色、哪种风格放在哪里。
在 NanoAPI 上，GPT Image 2.5 是产品 gpt_image 下的模型 gpt-image-2.5，有 Flare、Sunburst 两个版本，价格相同。每个任务带一段提示词和最多 16 张参考图，返回 1–4 张图，每张都有一个完整的 PNG 原图和一个长边不超过 1024 像素的 JPEG 预览图，链接公开、不会过期。版本、画质、分辨率、比例和张数每个任务都由你来定。
画质是最关键的参数：low 出图快，适合草稿、预览和大批量任务；high、xhigh、max 每张投入更多，适合最终定稿。画质和分辨率一起决定每张单价，每个任务都可以单独权衡，不用绑定某个套餐。
你可以先在本页顶部的工作台里在线使用 GPT Image 2.5，再在自己的应用里通过 https://api.nanoapi.ai/v1 调用 GPT Image 2.5 API。两边用同一份预付余额、同样的每张单价，而且只为拿到的图片付费：没生成出来的那几张退回，整个任务失败的全额退回。
价格
GPT Image 2.5 API 价格
按张计费，单价按画质和分辨率区分：只为任务实际返回的图片付费，variant 和 background 都不影响价格。
| 质量 | 1k 每张 | 2k 每张 | 4k 每张 |
|---|---|---|---|
低low | $0.0117 | $0.0234 | $0.0351 |
中medium | $0.0234 | $0.0468 | $0.0585 |
高high | $0.0702 | $0.1287 | $0.1989 |
很高xhigh | $0.117 | $0.2106 | $0.3276 |
最高max | $0.234 | $0.4212 | $0.702 |
实时的每张单价。费用 = 每张单价 × 张数；只按生成出来的张数扣费，生成失败全额退回。
使用步骤
如何使用 GPT Image 2.5 API
- 1
第 1 步: 获取 API Key
用 Google 登录 NanoAPI，在控制台的 API Keys 页面创建一个 Key。每个 API 请求都用它鉴权，请只放在你的服务端。
- 2
第 2 步: 充值余额
在控制台的充值页面充值。余额以美元预付，永不过期，NanoAPI 的所有模型共用，生图和生视频用的是同一份余额。
- 3
第 3 步: 创建任务
调用 POST /v1/tasks，传 model gpt-image-2.5、prompt、variant、quality、resolution、aspect_ratio 和 num_outputs，需要时再加上 image_urls 和 background。任务不到 1 秒就进入队列，几秒内冻结所请求张数的费用。
- 4
第 4 步: 获取图片
任务结束后推送一次到你的 webhook_url，也可以每隔 15 秒以上轮询 GET /v1/tasks/{task_id}。low 画质、1k 一张约 15 秒；PNG 原图在 outputs[].url，JPEG 预览图在 preview_url。
为什么选 NanoAPI
为什么在 NanoAPI 上使用 GPT Image 2.5 API
图片和视频共用一套接口
GPT Image 2.5 和 NanoAPI 的其他模型共用 POST /v1/tasks、同样的任务对象、同一个 API Key 和同一份预付余额，再加一个图片或视频模型都不用重新对接。
没生成出来的图不收费
任务按请求的张数冻结费用，只按实际返回的张数扣费。4 张里有 1 张被内容审核拦下时，任务仍然成功，那一张退回；一张都没出来时，全额退回。
带签名的回调
传一个 webhook_url，任务结束时收到一次推送，按 Standard Webhooks 规范签名，需要时可以验证。也可以轮询单个任务，或者一次查询一批任务 ID。
不会重复扣费
创建任务时带上 Idempotency-Key：请求超时后重发，拿到的是已经建好的那个任务，不会再建第二个。
每个 Key 都能设消费限额
在控制台给每个 API Key 设每小时、每天或总的消费限额，程序出错或者流量突增也不会花光余额。每个请求的状态、输入、费用和结果都能查到。
先在线试，再接入
本页工作台用的是同一个 GPT Image 2.5 模型、同样的价格，写代码之前就能定好画质和分辨率。文档还提供一份 llms.txt，方便交给 AI 编程助手。
使用场景
用 GPT Image 2.5 API 能做什么
Logo、图标和贴纸
把 background 设成 transparent 生成素材，PNG 直接放进设计稿、应用或印刷文件，不用再抠图。
商品图和广告
把商品作为 @Image1 传进来，放到大理石桌面上、厨房里或海报上，再用最多 16 张参考图保持品牌的视觉风格。
草稿要快，成品要精
先用 low 画质试想法，1k 一张约 15 秒；选定提示词之后，再用 high、xhigh 或 max 出最终成品。
给你的产品加上生图功能
把 GPT Image 2.5 接进设计工具、电商平台或内容流水线：批量创建任务，通过回调拿到图片，PNG 链接原样使用即可。
01什么是 GPT Image 2.5 API？
GPT Image 2.5 API 让你的应用通过 HTTP 调用 GPT Image 2.5 模型生成图片。在 NanoAPI 上调用 POST /v1/tasks，传 model gpt-image-2.5、提示词和出图参数，可以再带最多 16 张参考图，然后通过回调或轮询拿到 1–4 张图。
02GPT Image 2.5 API 怎么收费？
按张计费：所选画质和分辨率的每张单价 × 生成成功的张数。任务按 num_outputs 的张数冻结费用，只按实际返回的张数扣费，其余退回；任务失败全额退回。variant 和 background 不影响价格。按画质和分辨率区分的实时价格见上面的表格、价格页和 GET /v1/products。
03怎么生成透明背景的图片？
把 background 设成 transparent，带参考图也可以。outputs[].url 的 PNG 原图保留透明背景，preview_url 的 JPEG 预览图铺成白底。不传、auto、opaque 出的都是不透明的图；只在提示词里写「透明背景」，模型只会把棋盘格画进图里。这些都不影响价格。带透明背景的参考图会先铺成白底再使用。
04Flare 和 Sunburst 两个版本是什么？
GPT Image 2.5 的两个版本，用 variant 选择，参数和价格完全一样。Flare 速度快，适合日常创作和批量出图；Sunburst 细节更精准，适合精修和高质量成片，生成稍慢。
05最多能用几张参考图？支持哪些格式？
每个任务最多 16 张，以公开的 http(s) 链接放在 image_urls 里，在提示词里按顺序写 @Image1、@Image2… 引用。支持 JPEG、PNG、WebP、AVIF、GIF（取第一帧）、BMP 和 TIFF。不支持 HEIC / HEIF，iPhone 照片请先转成 JPEG，本页工作台会自动转换。
06GPT Image 2.5 支持哪些分辨率和比例？
resolution 可选 1k、2k、4k。aspect_ratio 可选 auto、1:1、3:2、2:3、4:3、3:4、4:5、5:4、16:9、9:16、21:9、27:16、16:27、9:8、8:9。auto 跟随第一张参考图的比例，没有参考图时按 1:1。quality 和版本不影响尺寸。
07只生成出一部分图片会怎样？
任务仍然算成功，outputs 里只有生成出来的那几张，可能比 num_outputs 少，例如其中一张被内容审核拦下。只按拿到的张数扣费，其余退回余额。只有一张都没生成出来时，任务才是失败，全额退回。
08GPT Image 2.5 生成要多久？可以先试用吗？
low 画质、1k 一张约 15 秒，多张并行生成，一个任务出 4 张和出 1 张的耗时差不多。想试用的话，用 Google 登录后直接用本页顶部的工作台：和 API 是同一个模型、同样的价格、同一份余额。
开始用 GPT Image 2.5 创作
先在上面的工作台试试 GPT Image 2.5，再通过 GPT Image 2.5 API 把同一个模型接进你的产品。