88API88API
使用指南AI 应用API 文档帮助支持
图像(Image)

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-21K (默认) / 2K / 4K
size 填像素
最多 4 张 (本地文件)固定 1 张按张
gpt-image-2.5-flare1K (默认) / 2K / 4K
size 填像素
最多 10 张 (本地文件)固定 1 张按张
gpt-image-2.5-sunburst1K (默认) / 2K / 4K
size 填像素
最多 10 张 (本地文件)固定 1 张按张
az-gpt-image-21K (默认) / 2K / 4K
size 填像素
最多 10 张 (本地文件 / Data URI / 公网 URL)最多 10 张按 token
az-gpt-image-2.5-flare1K (默认) / 2K / 4K
size 填像素
最多 10 张 (本地文件 / Data URI / 公网 URL)最多 10 张按 token
az-gpt-image-2.5-sunburst1K (默认) / 2K / 4K
size 填像素
最多 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

模型qualitybackgroundoutput_formatresponse_format
gpt-image-2low / medium / high不支持不支持b64_json / url
gpt-image-2.5-flarelow / medium / high不支持不支持b64_json / url
gpt-image-2.5-sunburstlow / medium / high不支持不支持b64_json / url
az-gpt-image-2low / medium / high / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-flarelow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_json / url
az-gpt-image-2.5-sunburstlow / medium / high / xhigh / max / autotransparent / opaque / autopng / webp / jpegb64_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)之间。

下表是各档位推荐使用的尺寸,所有模型通用:

比例1K2K4K
1:11024x10242048x20482880x2880
3:21536x10242400x16003504x2336
2:31024x15361600x24002336x3504
4:31152x8642048x15363264x2448
3:4864x11521536x20482448x3264
16:91280x7202560x14403840x2160
9:16720x12801440x25602160x3840
21:91344x5763024x12963840x1648
2:11408x7042880x14403840x1920
1:2704x14081440x28801920x3840

不传 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"
  }'

请求参数

参数类型必填说明
modelstring是图片模型名称,例如 gpt-image-2。
promptstring是图片内容描述。建议写清主体、构图、风格、光线和画幅。
sizestring否像素尺寸,规则见上文「尺寸」。
qualitystring否gpt-image-* 支持 low、medium、high。az-gpt-image-2 支持 low、medium、high、auto;az-gpt-image-2.5-* 另支持 xhigh、max。不传时按 low 生成。
ninteger否生成张数。az-gpt-image-* 支持 1 至 10;gpt-image-* 每次请求返回 1 张,需要多张时请发多个请求。
response_formatstring否b64_json(默认)或 url。选 url 时返回 88API 的图片链接。
backgroundstring否仅 az-gpt-image-*:transparent、opaque、auto。
output_formatstring否仅 az-gpt-image-*:png(默认)、webp、jpeg。
output_compressioninteger否仅 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 时,说明请求发到了错误的接口。