GPT Image 2.5

gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 可通过 OpenAI 兼容的 Images 接口生成图片。实际可用模型以账户权限为准。

接口与模型

POST /v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

model	说明
gpt-image-2.5-flare	Flare 模型
gpt-image-2.5-sunburst	Sunburst 模型

请求参数

参数	必填	说明
model	是	使用上表中的一个模型 ID
prompt	是	图片生成描述
size	否	输出尺寸，使用 WIDTHxHEIGHT，例如 1024x1024
quality	否	auto、low、medium 或 high；省略时由模型选择
n	否	生成图片数量，示例使用 1

标准 Images 接口使用 size 指定尺寸，不使用 resolution、aspect_ratio 或 image_size。GPT Image 模型返回 base64 图片；请不要传 response_format。

cURL 示例

将 model 改为 gpt-image-2.5-sunburst 即可调用 Sunburst。

curl -X POST https://cubicspaces.cloud/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A small blue circle centered on a plain white background",
    "size": "1024x1024",
    "quality": "low",
    "n": 1
  }'

返回结构

{
  "created": 1780000000,
  "data": [
    { "b64_json": "iVBORw0KGgo..." }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 196,
    "output_tokens_details": { "image_tokens": 196 }
  }
}

从 data[0].b64_json 读取图片内容并进行 base64 解码。usage 是本次请求的 token 用量，具体数值随请求变化。参考图编辑请使用 /v1/images/edits 上传图片文件；不要将 image_urls 传给文生图接口。