OpenAI GPT Image 图像生成

GPT Image 系列文生图 (gpt-image-2 / 1.5 / 1), 兼容 OpenAI SDK

POST /v1/images/generations

Auth: {'type': 'bearer', 'prefix': 'sk-', 'description': 'API Key, 使用 `Authorization: Bearer sk-xxx` 鉴权'}

> **本端点仅文生图 (t2i)**. 基于现有图片做图生图 (i2i / image-to-image) 请用 [`/v1/images/edits`](./openai-gpt-image-edit) (multipart 协议). OpenAI GPT Image 系列图像生成 — `gpt-image-2` (最新) / `gpt-image-1.5` / `gpt-image-1`. ## 模型矩阵 | 模型 | 特点 | |---|---| | `gpt-image-2` | 最新, 支持复杂构图与高分辨率 (最大 3840px), 推理能力强 | | `gpt-image-1.5` | 平衡质量与速度 | | `gpt-image-1` | 经典版, 兼容性最广 | ## 支持的 size (按 model 分) | size | gpt-image-1 / 1.5 | gpt-image-2 | |---|---|---| | `auto` | ✅ (模型默认) | ✅ (模型默认) | | `1024x1024` | ✅ | ✅ | | `1024x1536` / `1536x1024` | ✅ | ✅ | | `2048x2048` / `2048x1152` | — | ✅ | | `3840x2160` / `2160x3840` (4K) | — | ✅ | | `1792x1024` / `1024x1792` (DALL-E 3 兼容) | ⚠️ 部分 | — | | `256x256` / `512x512` (DALL-E 2 兼容) | ⚠️ 部分 | — | ⚠️ **size 约束 (`gpt-image-2`)**: 宽高都必须是 16 的倍数, 最长边 ≤ 3840px, 像素总数 655,360 ~ 8,294,400, 宽高比 ≤ 3:1. ## quality 档位 | quality | 说明 | |---|---| | `auto` (默认) | 模型自动选择 | | `low` / `medium` / `high` | gpt-image-* 原生三档 | | `standard` / `hd` | OpenAI SDK 兼容 alias (从 DALL-E 3 平迁的客户可直接用) | > 不同档位对图像细节与生成 token 数有显著影响. ## response 格式 `gpt-image-*` 始终返回 base64 内联 (`data[].b64_json`), 不支持 `url` 形式. `response_format` 字段保留是为 SDK 向后兼容, 实际被上游忽略. 返回顶层包含 `created / data / background / output_format / quality / size / usage`. `usage.input_tokens_details` 提供文本与图像 token 细分. ## 用法提示 - 客户端 SDK 调 `client.images.generate(model='gpt-image-2', prompt='...', size='1024x1024', quality='high')` 即可 - 兼容 OpenAI Python SDK / Node SDK 标准用法 - 单张 base64 体积可达几百 KB ~ 1 MB+, 客户端需自行 decode 保存 - 不支持 streaming (`stream` / `partial_images` 字段会被忽略) - `style` (DALL-E 3 字段) 在 `gpt-image-*` 不生效, 由模型自动选择风格

Request body

`model`	string	required	图像模型 ID, 如 `gpt-image-2` / `gpt-image-1.5` / `gpt-image-1`
`prompt`	string	required	文本描述, 支持中英文; 描述越具体生成质量越高
`n`	integer		生成图片数量
`size`	string		图像尺寸 (宽×高). 可用范围因 model 而异 — `gpt-image-2` 支持 4K + 自定义 (宽高 16 倍数, ≤3840px), `gpt-image-1` 系仅支持 1024² / 1024×1536 / 1536×1024 + 部分 DALL-E 兼容尺寸
`quality`	string		质量档位; 影响细节与推理 token 数. `low/medium/high` 是原生三档; `standard/hd` 是 OpenAI SDK 兼容 alias (DALL-E 风格); `auto` 由模型自动选择
`response_format`	string		返回格式. `gpt-image-*` 始终返 `b64_json` (上游忽略此字段); `url` 仅 DALL-E 系列生效
`output_format`	string		输出图像编码格式 (仅 `gpt-image-*` 支持)
`output_compression`	integer		压缩等级 (0-100, 越高质量越低体积越小); 仅 `jpeg` / `webp` 生效
`background`	string		背景类型; `transparent` 需配合 `output_format=png` 或 `webp`
`moderation`	string		内容审核严格度; `auto` 默认, `low` 较宽松 (仍由上游审核)
`user`	string		客户端可选传入的最终用户标识 (用于上游滥用检测)

Responses

200 — 成功返回生成图像 (gpt-image-* 始终返 b64_json, 顶层含 background/output_format/quality/size)
400 — 请求参数错误 (size 不支持 / 宽高非 16 倍数 / 像素超限等)
402 — 余额不足

Example

curl https://api.router.ai/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "雪夜中的东京街头, 霓虹灯倒影在湿润的柏油路上, 电影感",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

API reference