三步快速对接gpt-image-2：OpenAi最强绘图模型，脚踩Banana Pro

gpt-image-2 图像生成接口文档（xgapi 兼容版）

本文档基于 xgapi 图像生成接口整理，完全兼容 OpenAI 官方图像生成接口参数 ，逆向分组仅支持部分参数，可直接用于对接开发。

查看详情：https://api.xgapi.top/pricing?model=gpt-image-2

---

一、接口基础信息

对接文档：https://xgapi.apifox.cn/448732808e0

• 接口名称：gpt-image-2 创建图像
• 请求方式：POST
• 请求地址：https://api.xgapi.top/v1/images/generations
• 内容类型：application/json
• 兼容说明：官转分组完全兼容官方接口与参数；逆向分组仅支持 model/prompt/size/image，size 仅支持 1024×1024、1536×1024、1024×1536。

---

二、请求头（Header）

参数名	位置	类型	必填	说明
Authorization	Header	string	是	格式：Bearer <token>，替换为你的访问令牌
Content-Type	Header	string	是	固定值：application/json

---

三、请求体（Body）

必选参数

参数名	类型	必填	说明	示例
model	string	是	模型名称，固定为 gpt-image-2	gpt-image-2
prompt	string	是	图像描述提示词，最大长度 1000 字符	儿童绘本风格，兽医用水獭听诊器听小水獭心跳
n	integer	是	生成图像数量，取值 1--10	1

可选参数

参数名	类型	必填	说明	可选值
size	string	否	图片尺寸，默认 auto	1024×1024、1536×1024、1024×1536、2048×2048、2048×1152、3840×2160、2160×3840、auto
quality	string	否	画质，默认 auto	low、medium、high、auto
response_format	string	否	返回格式，默认 b64_json	url、b64_json

---

四、尺寸严格限制规则

1. 图片最大边长 ≤ 3840px
2. 宽高均为 16px 的倍数
3. 长边/短边 ≤ 3:1
4. 总像素：655360 ~ 8294400

---

五、请求示例

JSON 示例

{
    "model": "gpt-image-2",
    "prompt": "A childrens book drawing of a veterinarian using a stethoscope to listen to the heartbeat of a baby otter.",
    "n": 1,
    "size": "1024x1024",
    "quality": "low"
}

cURL 示例

curl --location --request POST 'https://api.xgapi.top/v1/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "gpt-image-2",
    "prompt": "A childrens book drawing of a veterinarian using a stethoscope to listen to the heartbeat of a baby otter.",
    "n": 1,
    "size": "1024x1024",
    "quality": "low"
}'

---

六、响应说明

成功响应（200 OK）

字段	类型	说明
data	arrayobject	生成图像数据列表
data\[\].url	string	图片地址（response_format=url 时返回）
data\[\].b64_json	string	图片 base64 编码（默认返回）
data\[\].revised_prompt	string	优化后提示词
created	integer	生成时间戳
id	string	请求唯一标识
object	string	对象类型
choices	arrayobject	生成结果选项
usage	object	用量信息
usage.prompt_tokens	integer	提示词 token 数
usage.completion_tokens	integer	生成 token 数
usage.total_tokens	integer	总 token 数

响应示例

{
    "data": [
        {
            "url": "https://image.xgapiproxy.win/images/openai/2026/04/23/2262bbaa-95cb-4556-92c7-a42ec1c63ecb.png",
            "b64_json": "",
            "revised_prompt": ""
        }
    ],
    "created": 1776952022
}

---

七、注意事项

1. 逆向分组仅支持 model/prompt/size/image，size 仅限三种基础尺寸，超出将报错。
2. 提示词长度不超过 1000 字符，否则请求失败。
3. 生成数量 n 必须在 1--10 之间，超出范围报错。
4. 尺寸必须满足四条限制规则，否则接口返回参数错误。

八、效果展示

生成一张 K-POP 女团第三张迷你专辑的概念海报，专辑名 ECLIPSE。所有人都穿黑色系造型，打光是侧逆光加柔焦，整体色调偏冷灰蓝，肢体、影子自然真实，脸部细节、发丝、饰品光泽、布料褶皱质感精致，每个人有不同的 pose 和表情。

生成一张超真实的城市街头群像照片，场景是夏夜十点的便利店门口，三到四个年轻人正在门口短暂停留聊天，有人拿着饮料，有人坐在店外塑料椅上，有人站着低头看手机。便利店的玻璃门和橱窗透出明亮白光，外面路边则是暖黄街灯和远处车灯。人物穿搭非常日常，包含 T 恤、衬衫、短裤、牛仔裤、运动鞋，不要网红穿搭感，脸部状态和体态都要像真实路人，不能每个人都过于精致。环境要有真实便利店元素，冰柜贴纸、促销海报、垃圾桶、门口地垫、玻璃倒影、路边共享单车、地面饮料瓶水珠。画面像摄影师在城市里拍到的一张非常真实的生活切片，重点测试多人自然互动、夜间便利店灯光、玻璃反射和普通人气质的还原能力。

更多效果：