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

简介

GPT-Image-2 是 OpenAI 的图像模型,通过 POST /v1/images/generations 将文本描述转为图片,适用于插画、商品素材、海报和信息图。支持灵活尺寸以及 PNG、JPEG、WebP 输出。使用 quality、size 和 background 调整生成结果;透明背景属于该模型的预览能力,需确认当前项目和渠道是否支持。

认证

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。 quality 使用 auto / low / medium / high,默认 auto。透明背景是 image-2 的预览能力;可用时使用 background=transparent,且输出格式选 PNG 或 WebP。仅介绍栅格生成与编辑,不将 2.6 的 complexity、GIF、SVG 或 2.5 的 markup 能力直接套用。

响应示例

下面是非流式响应的结构示意,图片数据和 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);平台实际结算以控制台为准。

官方参考