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 |
四、尺寸严格限制规则
- 图片最大边长 ≤3840px
- 宽高均为16px的倍数
- 长边/短边 ≤3:1
- 总像素：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--requestPOST'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 | array[object] | 生成图像数据列表 |
| data[].url | string | 图片地址（response_format=url 时返回） |
| data[].b64_json | string | 图片 base64 编码（默认返回） |
| data[].revised_prompt | string | 优化后提示词 |
| created | integer | 生成时间戳 |
| id | string | 请求唯一标识 |
| object | string | 对象类型 |
| choices | array[object] | 生成结果选项 |
| 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}七、注意事项
- 逆向分组仅支持
model/prompt/size/image，size仅限三种基础尺寸，超出将报错。 - 提示词长度不超过1000 字符，否则请求失败。
- 生成数量
n必须在1–10之间，超出范围报错。 - 尺寸必须满足四条限制规则，否则接口返回参数错误。
八、效果展示
生成一张 K-POP 女团第三张迷你专辑的概念海报，专辑名 ECLIPSE。所有人都穿黑色系造型，打光是侧逆光加柔焦，整体色调偏冷灰蓝，肢体、影子自然真实，脸部细节、发丝、饰品光泽、布料褶皱质感精致，每个人有不同的 pose 和表情。
生成一张超真实的城市街头群像照片，场景是夏夜十点的便利店门口，三到四个年轻人正在门口短暂停留聊天，有人拿着饮料，有人坐在店外塑料椅上，有人站着低头看手机。便利店的玻璃门和橱窗透出明亮白光，外面路边则是暖黄街灯和远处车灯。人物穿搭非常日常，包含 T 恤、衬衫、短裤、牛仔裤、运动鞋，不要网红穿搭感，脸部状态和体态都要像真实路人，不能每个人都过于精致。环境要有真实便利店元素，冰柜贴纸、促销海报、垃圾桶、门口地垫、玻璃倒影、路边共享单车、地面饮料瓶水珠。画面像摄影师在城市里拍到的一张非常真实的生活切片，重点测试多人自然互动、夜间便利店灯光、玻璃反射和普通人气质的还原能力。
更多效果：
