本系列支持的端点
- 文生图
POST https://zexapi.com/v1/images/generations - 图片编辑
POST https://zexapi.com/v1/images/edits - Chat 兼容
POST https://zexapi.com/v1/chat/completions
POSThttps://zexapi.com/v1/images/generations
鉴权 Authorization: Bearer YOUR_API_KEY
使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。
当前在架 GPT 图片全系列均支持同步与异步。基础型号的清晰度跟随型号;flare / sunburst 系列可用 size 选择 1K / 2K / 4K,VIP 型号可选质量。生成、编辑与 Chat 使用各自端点。
gpt-image 接口文档(OpenAI 原生格式)
接口地址
| 用途 | 方法 | 路径 | 响应格式 |
|---|
| 文生图(图片 API) | POST | /v1/images/generations | { created, data: [{ url, b64_json }] }(缺省双给,可用 response_format 单选) |
| 图生图(图片编辑) | POST | /v1/images/edits | 同上 |
| 文生图 / 图生图(Chat API) | POST | /v1/chat/completions | chat.completion;图片在 message.content 的 markdown 里,Base64 在 message.images[0].b64_json |
默认同步一次性 JSON。可选 "stream": true 走 SSE(应对 524),见下文「流式 SSE」。
功能说明
采用 OpenAI 原生端点格式的图片生成接口,支持文生图和图生图两种模式。/v1/images/generations、/v1/images/edits:标准图片 API,缺省返回 { data: [{ url, b64_json }] }。
/v1/chat/completions:兼容 Chat Completions 调用方式;将 messages 自动转为内部提示词与参考图,响应为 Chat 格式(),Base64 走扩展字段。
三个端点的 response_format 语义完全一致:| 传值 | 返回内容 |
|---|
| 不传(推荐) | 同时返回 URL 与 Base64 |
"url" | 只返回图片 URL |
"b64_json" | 只返回 Base64(纯字符串,不含 data: 前缀) |
缺省双给时回包体积更大;若只需要链接,请显式传 "response_format": "url"。
支持的模型
当前在架 GPT 图片全系列均支持同步与异步。基础型号的清晰度跟随型号;flare / sunburst 系列可用 size 选择 1K / 2K / 4K,VIP 型号可选质量。生成、编辑与 Chat 使用各自端点。| model 参数 | 分辨率 | 质量 | 说明 |
|---|
gpt-image-2 | 1K | 固定 medium | 同步与异步均支持;清晰度跟随型号,size 使用对应档位像素 |
gpt-image-2.5 | 1K | 固定 medium | 同步与异步均支持;清晰度跟随型号,size 使用对应档位像素 |
gpt-image-2-2K | 2K | 固定 medium | 同步与异步均支持;清晰度跟随型号,size 使用对应档位像素 |
gpt-image-2-4K | 4K | 固定 medium | 同步与异步均支持;清晰度跟随型号,size 使用对应档位像素 |
gpt-image-2.5-flare | 1K / 2K / 4K | 固定 medium | 用 size 选分辨率 |
gpt-image-2.5-sunburst | 1K / 2K / 4K | 固定 medium | 用 size 选分辨率 |
gpt-image-2.5-flare-vip | 1K / 2K / 4K | low / medium / high | 不传 quality 则自动判断 |
gpt-image-2.5-sunburst-vip | 1K / 2K / 4K | low / medium / high | 不传 quality 则自动判断 |
非 -vip 模型质量固定为 medium,可不传 quality。-vip 模型可在请求里传 quality:low、medium、high。
请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | 图片 API:支持 application/json 与 multipart/form-data;Chat API:仅 application/json |
一、文生图接口
接口地址
POST /v1/images/generations请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|
| model | string | 是 | 模型名称,见上表 |
| prompt | string | 是 | 图片描述,用于生成图片 |
| size | string | 否 | 图片尺寸,格式 "宽x高"。同步接口用 size 选 1K / 2K / 4K,固定比例见下表 |
| quality | string | 否 | 仅 -vip 模型:low、medium、high。不传则自动判断。其余模型质量固定为 medium,可不传 |
| response_format | string | 否 | 不传 = URL + Base64 双给;"url" = 只要链接;"b64_json" = 只要 Base64 |
常用 size 速查
| 比例 | size(1K) | size (2K) | size(4K) |
|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 3:2 | 1248x832 | 2496x1664 | 3504x2336 |
| 2:3 | 832x1248 | 1664x2496 | 2336x3504 |
| 4:3 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 864x1152 | 1728x2304 | 2448x3264 |
| 5:4 | 1120x896 | 2240x1792 | 3200x2560 |
| 4:5 | 896x1120 | 1792x2240 | 2560x3200 |
| 21:9 | 1456x624 | 3024x1296 | 3696x1584 |
请求示例(JSON — 纯文生图,1K)
curl -X POST "https://xxxxxx.com/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-flare",
"prompt": "生成竖屏图片 xxx抖音带货",
"size": "720x1280"
}'
请求示例(JSON — 纯文生图,支持 2K/4K)
curl -X POST "https://xxxxxx.com/v1/images/generations" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-flare",
"prompt": "生成竖屏图片 xxx抖音带货",
"size": "3696x1584"
}'
四、响应示例(图片 API)
缺省(同时返回 URL 与 Base64)
{
"created": 1782108238,
"data": [
{
"url": "https://res.papir.cc/output/2026-04-18/xxxxxx.png",
"b64_json": "iVBORw0KGgoAAAANSU..."
}
]
}
只要 URL(请求体加 "response_format": "url")
{
"created": 1782108238,
"data": [
{
"url": "https://res.papir.cc/output/2026-04-18/xxxxxx.png"
}
]
}
只要 Base64(请求体加 "response_format": "b64_json")
{
"created": 1782108238,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSU..."
}
]
}
图片 API 取参
| 需要 | 取哪里 |
|---|
| 图片 URL | data[0].url |
| Base64 | data[0].b64_json |