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 示例
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 示例
bash
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 | 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 数 |
响应示例
json
{
"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 恤、衬衫、短裤、牛仔裤、运动鞋,不要网红穿搭感,脸部状态和体态都要像真实路人,不能每个人都过于精致。环境要有真实便利店元素,冰柜贴纸、促销海报、垃圾桶、门口地垫、玻璃倒影、路边共享单车、地面饮料瓶水珠。画面像摄影师在城市里拍到的一张非常真实的生活切片,重点测试多人自然互动、夜间便利店灯光、玻璃反射和普通人气质的还原能力。

更多效果:




