GPT-Image-2 API
2026-04 image gen
- 模型名:
gpt-image-2 - 厂商: OpenAI
- 类型: image
POST /v1/images/generations
gpt-image-2:影像生成,含必填項、巢狀響應和虛構示例。
基础调用
必填参数: model, prompt
可用参数: model, prompt, n, size, quality, output_format, background
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|
model | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选: gpt-image-2 |
prompt | string | 是 | 图像描述;编辑场景应描述期望的修改。 |
n | integer | 否 | 生成张数,例子为1张。 |
size | string | 否 | 图像规格,允许值依本型号。 |
quality | string | 否 | 输出质量,支持档位按型号。 |
output_format | string | 否 | 图像编码格式。 可选: png / jpeg / webp |
background | string | 否 | 背景模式。 可选: auto / opaque / transparent |
## 使用与响应约定
- 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。
- 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。
- 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。
- 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。
- 生成文件请及时保存;不要假设结果链接永久有效。
## 参考
参数术语参考[OpenAI Images官方说明](https://developers.openai.com/api/reference/resources/images/methods/generate);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。
## 完整嵌套字段说明
数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。
### 请求头
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `Content-Type` | string | 是 | 请求体格式为application/json。 |
### 请求体
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:gpt-image-2 |
| `prompt` | string | 是 | 图像描述;编辑场景应描述期望的修改。 |
| `n` | integer | 否 | 生成张数,例子为1张。 最小值:1 |
| `size` | string | 否 | 图像规格,允许值依本型号。 |
| `quality` | string | 否 | 输出质量,支持档位按型号。 |
| `output_format` | string | 否 | 图像编码格式。 可选值:png, jpeg, webp |
| `background` | string | 否 | 背景模式。 可选值:auto, opaque, transparent |
### 响应 200
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `created` | integer | 否 | 创建时间,Unix秒。 |
| `data` | array[object] | 否 | 图像结果,按实际返回选择url或b64_json。 |
| `data[].url` | string | 否 | 图像URL,如果本次采用URL输出。 |
| `data[].b64_json` | string | 否 | Base64图像数据,如果本次采用内联输出。 |
| `data[].revised_prompt` | string | 否 | 返回时的改写提示词,可省略。 |
| `usage` | object | 否 | 可选用量;子字段按实际返回。 |
| `usage.input_tokens` | integer | 否 | 输入Token。 |
| `usage.output_tokens` | integer | 否 | 输出Token。 |
| `usage.total_tokens` | integer | 否 | 总Token。 |
### 错误响应结构
| 字段路径 | 类型 | 所属对象内必填 | 含义 |
|---|---|---|---|
| `error` | object | 否 | 错误详情;以本次返回为准。 |
| `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 |
| `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 |
| `error.code` | string | 否 | 错误码,可能为空。 |
请求示例
curl --request POST https://api.router.ai/v1/images/generations \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"model": "gpt-image-2",
"prompt": "A fictional blue paper boat on a plain white background."
}'
接口通用说明: Aliyun Qwen-Image 文生圖