generations OpenAI 原生格式）

接口地址

文生图：POST /v1/images/generations

图生图（图片编辑）：POST /v1/images/edits

文生图流式返回: POST ： /v1/chat/completions` （常规OpenAi格式调用即可，不在后续文档赘述）

功能说明

采用 OpenAI 兼容格式的图片生成接口，支持文生图和图生图两种模式，支持同步返回和流式返回两种调用方式。
###一次请求只能生成一张图片!!!

支持的模型

model 参数	说明
`image2`	GPT 图片生成模型

请求头

参数名	类型	必填	说明
Authorization	string	是	Bearer YOUR_API_KEY
Content-Type	string	是	文生图 / 图生图均支持 `application/json` 与 `multipart/form-data`

一、文生图接口

接口地址

POST /v1/images/generations

请求参数

参数名	类型	必填	说明
model	string	是	模型名称，固定为 `image2`
prompt	string	是	图片描述，用于生成图片
size	string	否	图片尺寸，格式自己定义
n	number	否	生成数量默认为1,最大为4
image	string 或 string[]	否	带参考图：单张传字符串，多张传数组。不传则为纯文生图

请求示例（JSON 格式 — 纯文生图）

请求示例（JSON 格式 — 带参考图 URL，单图或多图）

请求示例（表单格式）

二、图生图（图片编辑）接口

接口地址

POST /v1/images/edits

请求参数

参数名	类型	必填	说明
model	string	是	模型名称，固定为 `image2`
prompt	string	是	图片描述，用于编辑图片
image	见说明	是	JSON：`string`（单图）或 `string[]`（多图），Multipart：一个或多个文件字段（字段名依上游约定，常见为 `image` / `image[]`）
size	string	否	图片尺寸，格式同文生图

请求示例（JSON — URL 或多图 URL）

请求示例（JSON — Data URL / Base64）

{
  "model": "image2",
  "prompt": "变成灰色",
  "size": "1024x1792",
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg=="
}

多图时 "image": ["data:image/png;base64,...", "https://..."] 与 generations 用法一致。

请求示例（表单格式 - 本地文件）

请求示例（多图上传）

Python 示例（JSON，直接传 URL）

Python 示例（multipart 上传本地文件）

三、响应示例

同步响应 - Base64 格式（默认）

{
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSU..."
        }
    ],
    "created": 1782108238,
    "usage": {
        "input_tokens": 4,
        "output_tokens": 1105,
        "total_tokens": 1109,
        "input_tokens_details": {
            "text_tokens": 4,
            "image_tokens": 0
        },
        "output_tokens_details": {
            "text_tokens": 0,
            "image_tokens": 1105
        }
    }
}

任务状态说明

status	说明
`queued`	任务排队中
`in_progress`	任务处理中
`completed`	任务已完成
`failed`	任务失败

注意事项

接口格式：采用 OpenAI 兼容的原生图片接口格式，与 OpenAI 官方 SDK 通用

调用方式：接口直接返回生成结果，适合对实时性要求高的场景

响应格式：

b64_json（默认）：直接返回 Base64 编码的图片数据，前端可直接渲染

尺寸支持：

竖屏：1024x1792

横屏：1792x1024

方形：1024x1024

其他尺寸：可在size参数自由设置

参考图与格式：/v1/images/generations 与 /v1/images/edits 均可在 application/json 下用 image 传 URL 或 Base64 / Data URL（字符串或数组）；需要走文件流时用 multipart/form-data。具体字段名、是否支持裸 Base64 以实际上游实现为准

参考图片格式：支持 JPEG、PNG、WEBP 格式

图片有效期：返回的图片 URL 有效期为 2 小时，请及时下载保存

模型区别：该接口使用模型名 image2，如需通过 /v1/videos 接口调用，请使用模型名 gpt-image-2

application/json

Bodyapplication/json

示例

{
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSU..."
        }
    ],
    "created": 1782108238,
    "usage": {
        "input_tokens": 4,
        "output_tokens": 1105,
        "total_tokens": 1109,
        "input_tokens_details": {
            "text_tokens": 4,
            "image_tokens": 0
        },
        "output_tokens_details": {
            "text_tokens": 0,
            "image_tokens": 1105
        }
    }
}

image2（同步）

gpt-image-2 接口文档（/v1/images/generations OpenAI 原生格式）

接口地址

功能说明

支持的模型

请求头

一、文生图接口

接口地址

请求参数

请求示例（JSON 格式 — 纯文生图）

请求示例（JSON 格式 — 带参考图 URL，单图或多图）

请求示例（表单格式）

二、图生图（图片编辑）接口

接口地址

请求参数

请求示例（JSON — URL 或多图 URL）

请求示例（JSON — Data URL / Base64）

请求示例（表单格式 - 本地文件）

请求示例（多图上传）

Python 示例（JSON，直接传 URL）

Python 示例（multipart 上传本地文件）

三、响应示例

同步响应 - Base64 格式（默认）

任务状态说明

注意事项

请求参数

请求示例代码

返回响应

image2（同步）

gpt-image-2 接口文档（/v1/images/generations OpenAI 原生格式）#

接口地址#

功能说明#

支持的模型#

请求头#

一、文生图接口#

接口地址#

请求参数#

请求示例（JSON 格式 — 纯文生图）#

请求示例（JSON 格式 — 带参考图 URL，单图或多图）#

请求示例（表单格式）#

二、图生图（图片编辑）接口#

接口地址#

请求参数#

请求示例（JSON — URL 或多图 URL）#

请求示例（JSON — Data URL / Base64）#

请求示例（表单格式 - 本地文件）#

请求示例（多图上传）#

Python 示例（JSON，直接传 URL）#

Python 示例（multipart 上传本地文件）#

三、响应示例#

同步响应 - Base64 格式（默认）#

任务状态说明#

注意事项#

请求参数

请求示例代码

返回响应

gpt-image-2 接口文档（/v1/images/generations OpenAI 原生格式）

接口地址

功能说明

支持的模型

请求头

一、文生图接口

接口地址

请求参数

请求示例（JSON 格式 — 纯文生图）

请求示例（JSON 格式 — 带参考图 URL，单图或多图）

请求示例（表单格式）

二、图生图（图片编辑）接口

接口地址

请求参数

请求示例（JSON — URL 或多图 URL）

请求示例（JSON — Data URL / Base64）

请求示例（表单格式 - 本地文件）

请求示例（多图上传）

Python 示例（JSON，直接传 URL）

Python 示例（multipart 上传本地文件）

三、响应示例

同步响应 - Base64 格式（默认）

任务状态说明

注意事项