跳转到主要内容
POST
GPT-Image-2.5 · 文生图

简介

GPT-Image-2.5 是 OpenAI 的图像生成模型系列,包含注重日常生成速度的 Flare 和注重视觉细节的 Sunburst。本页通过 POST /v1/images/generations 将文本描述转为图片,适用于海报、商品展示、品牌插画、图标和信息图等场景。 两个模型支持 auto、low、medium、high、xhigh、max 六档质量设置,以及 PNG、JPEG、WebP 输出。可通过 quality、size 和 background 调整质量、尺寸与背景;透明背景请配合 PNG 或 WebP。

模型选择

两个模型共用本页的端点、参数和响应结构。示例默认使用 Flare;切换为 Sunburst 时只需替换请求中的 model,其他字段按实际需求设置。

认证

string
必填
Bearer $GRAVITEX_API_KEY
string
必填
application/json

请求参数

请求示例

示例从环境变量 GRAVITEX_API_KEY 读取平台令牌,请先在当前终端设置该变量。文件上传使用 curl 的 -F 自动生成 Content-Type 和 boundary,不要手动把 Content-Type 固定成 multipart/form-data。

基础生成

透明背景

user 为兼容旧请求保留,已废弃;新请求使用 safety_identifier。非空 safety_identifier 优先,未提供、null 或空字符串时才回退 user。

流式输出

限制与注意事项

auto 为默认值。显式尺寸使用 WxH,宽高均为 16 的倍数,宽高比在 1:3–3:1 之间。image-2 官方指南规定最长边不超过 3840px、总像素为 655,360–8,294,400;2.5 的 API 参考也要求尺寸符合模型的边长和像素预算。2.6(尤其 GIF)的预算请按模型和项目实际支持确认,不直接套用旧模型上限。 本页仅列出官方明确说明的 GPT-Image-2.5 用法,不将 2.6 的 complexity、GIF、SVG 专属说明直接套用到 2.5。通用 API schema 出现某字段,不代表所有模型和渠道都支持。

响应示例

下面是非流式响应的结构示意,图片数据和 token 数仅为示例,并非实际生成结果。将 b64_json 解码为对应格式的文件;不要将 Base64 字符串直接保存为图片。
若设置 stream: true,响应为 SSE 事件流;按事件读取中间预览和最终图片,不能对整个响应直接调用 JSON 解析。

响应与计费

本页示例为非流式调用时,图片通过 b64_json 返回;不要传 response_format=url 期待图片链接。输入图片和输出图片均有 token 用量;相同 token 单价不代表相同单张费用,需结合实际 usage。 返回 data[].b64_json 和 usage。图片数据须先 Base64 解码再保存。以下为 OpenAI 官方标准价,不是 GravitexAI 报价。 缓存价格是官方参考费率。官方指南说明,GPT Image 2 / 2.5 的缓存输入优惠仅适用于 Responses API 图像工具,不适用于直接调用本页 Images API(含 edits);平台实际结算以控制台为准。

官方参考