OpenAI 图片模型 API
gpt-image-2、gpt-image-2.5 与 az-gpt-image 系列图片模型的接口、尺寸、质量档位、参考图和透明背景说明。
适用范围
本页介绍 OpenAI 图片模型(gpt-image-* 与 az-gpt-image-*)的图片接口。Gemini 图片模型请参阅 Gemini 图片模型 API,Grok 图片模型请参阅 Grok 图片模型 API。
接口选择
OpenAI 图片模型只使用图片接口,不要用 /v1/chat/completions 或 /v1/responses 代替:
| 用途 | 请求方法 | 端点 |
|---|---|---|
| 文生图 | POST | /v1/images/generations |
| 图片编辑 | POST | /v1/images/edits |
模型与能力
| 模型 | 分辨率 | 参考图 | 单次张数 | 计费 |
|---|---|---|---|---|
gpt-image-2 | 1K (默认) / 2K / 4Ksize 填像素 | 最多 4 张 (本地文件) | 固定 1 张 | 按张 |
gpt-image-2.5-flare | 1K (默认) / 2K / 4Ksize 填像素 | 最多 10 张 (本地文件) | 固定 1 张 | 按张 |
gpt-image-2.5-sunburst | 1K (默认) / 2K / 4Ksize 填像素 | 最多 10 张 (本地文件) | 固定 1 张 | 按张 |
az-gpt-image-2 | 1K (默认) / 2K / 4Ksize 填像素 | 最多 10 张 (本地文件 / Data URI / 公网 URL) | 最多 10 张 | 按 token |
az-gpt-image-2.5-flare | 1K (默认) / 2K / 4Ksize 填像素 | 最多 10 张 (本地文件 / Data URI / 公网 URL) | 最多 10 张 | 按 token |
az-gpt-image-2.5-sunburst | 1K (默认) / 2K / 4Ksize 填像素 | 最多 10 张 (本地文件 / Data URI / 公网 URL) | 最多 10 张 | 按 token |
支持的比例:1:1 (默认) / 3:2 / 2:3 / 4:3 / 3:4 / 16:9 / 9:16 / 21:9 / 2:1 / 1:2
| 模型 | quality | background | output_format | response_format |
|---|---|---|---|---|
gpt-image-2 | low / medium / high | 不支持 | 不支持 | b64_json / url |
gpt-image-2.5-flare | low / medium / high | 不支持 | 不支持 | b64_json / url |
gpt-image-2.5-sunburst | low / medium / high | 不支持 | 不支持 | b64_json / url |
az-gpt-image-2 | low / medium / high / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-flare | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
az-gpt-image-2.5-sunburst | low / medium / high / xhigh / max / auto | transparent / opaque / auto | png / webp / jpeg | b64_json / url |
两组模型的请求方法相同,区别在于可用参数和计费方式:
gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst:按张计费,价格与尺寸、质量档位无关。支持size、quality,每次请求返回 1 张。az-gpt-image-2、az-gpt-image-2.5-flare、az-gpt-image-2.5-sunburst:支持完整的 OpenAI Images 参数,包括透明背景background、输出格式output_format、单次多张n(最多 10)、流式预览,以及 JSON 方式的编辑请求。按 token 计费,费用随尺寸和质量档位变化。
实际可用模型以控制台返回的模型列表为准。
鉴权
所有请求都需要携带 88API 的访问令牌:
Authorization: Bearer $API_KEY
Content-Type: application/json尺寸
size 必须写成像素 宽x高,不接受 1K、2K、4K 这类字符串。合法尺寸需要同时满足:
- 宽和高都是 16 的倍数;
- 最长边不超过 3840;
- 长边与短边之比不超过 3:1;
- 总像素在 655,360(约 816×816)到 8,294,400(3840×2160)之间。
下表是各档位推荐使用的尺寸,所有模型通用:
| 比例 | 1K | 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1536x1024 | 2400x1600 | 3504x2336 |
| 2:3 | 1024x1536 | 1600x2400 | 2336x3504 |
| 4:3 | 1152x864 | 2048x1536 | 3264x2448 |
| 3:4 | 864x1152 | 1536x2048 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1344x576 | 3024x1296 | 3840x1648 |
| 2:1 | 1408x704 | 2880x1440 | 3840x1920 |
| 1:2 | 704x1408 | 1440x2880 | 1920x3840 |
不传 size 或传 auto 时,由模型自行决定尺寸。不符合上述规则的尺寸可能被拒绝或被自动调整,请在请求前自行校验。
文生图
请求
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "一只坐在窗边的橘猫,午后的自然光,写实摄影风格",
"size": "2048x2048",
"quality": "medium"
}'请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 图片模型名称,例如 gpt-image-2。 |
prompt | string | 是 | 图片内容描述。建议写清主体、构图、风格、光线和画幅。 |
size | string | 否 | 像素尺寸,规则见上文「尺寸」。 |
quality | string | 否 | gpt-image-* 支持 low、medium、high。az-gpt-image-2 支持 low、medium、high、auto;az-gpt-image-2.5-* 另支持 xhigh、max。不传时按 low 生成。 |
n | integer | 否 | 生成张数。az-gpt-image-* 支持 1 至 10;gpt-image-* 每次请求返回 1 张,需要多张时请发多个请求。 |
response_format | string | 否 | b64_json(默认)或 url。选 url 时返回 88API 的图片链接。 |
background | string | 否 | 仅 az-gpt-image-*:transparent、opaque、auto。 |
output_format | string | 否 | 仅 az-gpt-image-*:png(默认)、webp、jpeg。 |
output_compression | integer | 否 | 仅 az-gpt-image-*,0 至 100,只对 jpeg、webp 生效。 |
响应示例
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}默认返回 data[].b64_json;请求时指定 "response_format": "url" 则返回 data[].url。
图片编辑
图片编辑使用 /v1/images/edits,上传本地图片时使用 multipart/form-data,多张参考图重复传 image[]。最多 10 张(gpt-image-2 最多 4 张),支持 PNG、JPEG、WebP。
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-F "model=gpt-image-2" \
-F "image[]=@person.png" \
-F "image[]=@product.png" \
-F "prompt=让第一张图中的人物手持第二张图中的产品,保持人物和产品外观不变" \
-F "size=1536x1024"参考图按上传顺序编号,提示词里可以用「第一张」「第二张」指代。
JSON 编辑请求(仅 az-gpt-image-*)
az-gpt-image-* 还支持 JSON 格式的编辑请求,参考图可以是 Data URI 或公网 URL:
curl https://api.88api.ai/v1/images/edits \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2.5-flare",
"prompt": "把背景替换为浅蓝色摄影棚",
"images": [
{ "image_url": "data:image/png;base64,..." },
{ "image_url": "https://example.com/reference.png" }
],
"size": "1024x1024"
}'gpt-image-* 请使用 multipart 上传。
透明背景(仅 az-gpt-image-*)
需要透明底的贴纸、图标或抠图时,设置 background 为 transparent,并使用 png 或 webp 输出:
curl https://api.88api.ai/v1/images/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "az-gpt-image-2",
"prompt": "一只举着「加油」牌子的熊猫贴纸,干净的描边",
"size": "1024x1024",
"background": "transparent",
"output_format": "png"
}'jpeg不支持透明,搭配transparent时会返回不透明图片。- 编辑时传
transparent可以去除背景;参考图本身是透明的,输出也会保留透明。 opaque不能完全保证不透明:提示词明确要求「贴纸」「无背景」时,仍可能返回透明图片。
流式预览(仅 az-gpt-image-*)
设置 "stream": true 和 "partial_images": 1 至 3,接口以 SSE 返回 image_generation.partial_image 中间预览,最后一个事件 image_generation.completed 带最终图片和用量;编辑请求的事件名为 image_edit.*。
计费说明
gpt-image-*按成功返回的张数计费,与尺寸、质量档位无关。az-gpt-image-*按 token 计费:文字输入、图片输入(参考图)、图片输出分别计价。输出 token 只取决于尺寸和质量档位,档位越高费用越高;az-gpt-image-2.5-*同名档位的 token 低于az-gpt-image-2(2.5 的high约等于 2 的medium)。- 请求失败不扣费。
重要限制
- 不要把这些模型的请求发到
/v1/responses或/v1/chat/completions。 - 不支持
mask局部重绘:传入的遮罩不会按区域重绘,需要局部修改时请在提示词里描述位置。 - 不支持
input_fidelity参数。 - 不建议使用 GIF 作为参考图,请先转换为 PNG。
- 高质量档位和 4K 尺寸可能需要 1 至 2 分钟,
az-gpt-image-2.5-*的max档最长约 2 分半,客户端超时建议设置为 5 分钟以上。 - 返回
Invalid size ...时,按上文「尺寸」的规则检查size。 - 返回
This model does not support image generation.或image_model_wrong_endpoint时,说明请求发到了错误的接口。