OpenAI Images API 兼容文档

请求端点

调用兼容图片生成接口时，请使用以下 HTTP 地址与 Bearer 鉴权方式。

POST · Images Generations

Method: POST Model: gpt-image-2 Auth: Bearer

http://10.0.88.12:7777/v1/images/generations

鉴权方式

Authorization: Bearer YOUR_API_KEY

不要把真实 Key 硬编码到公开静态页面、前端仓库或客户端源码中。

公开模型

gpt-image-2

请求体中的 `model` 字段固定填写为 `gpt-image-2`。

快速开始

发送一个 POST 请求到图片生成接口，提交提示词和图片参数。成功后会返回标准的 `data[].b64_json` 字段，解码后即可保存为图片文件。

cURL Example

curl http://10.0.88.12:7777/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只可爱的白色小猫，超写实摄影风格，柔和自然光，浅景深",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png"
  }'

请求参数

以下参数与 OpenAI Images 风格保持兼容，适合直接复用你的图片生成请求结构。

字段	类型	说明
`model`	string	固定填写 `gpt-image-2`。
`prompt`	string	图片描述文本，不能为空。
`size`	string	输出尺寸，例如 `1024x1024`、`1024x1536`、`1536x1024`。
`quality`	string	图片质量，当前推荐 `high`。
`output_format`	string	输出格式，当前推荐 `png`。
`n`	integer	生成图片数量，支持 1-10。例如传 2 会返回两张图。

请求示例

支持单图与多图生成，返回格式统一为 `data[].b64_json`。

单图生成

{
  "model": "gpt-image-2",
  "prompt": "一位韩系女团风格的年轻女孩，超写实摄影，9:16，iPhone 15 Pro Max 广角镜头质感",
  "size": "1024x1536",
  "quality": "high",
  "output_format": "png"
}

多图生成

{
  "model": "gpt-image-2",
  "prompt": "两只可爱的白色小猫，超写实摄影风格，柔和自然光，浅景深",
  "size": "1024x1024",
  "quality": "high",
  "output_format": "png",
  "n": 2
}

返回格式

成功时返回标准 JSON，对应图片数据位于 `data[].b64_json`。

Success Response

{
  "created": 1776942000,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAA..."
    }
  ]
}

Python 示例

下面的示例演示了如何使用 `httpx` 发起请求，并把返回的 Base64 数据解码后保存为 PNG 文件。

Python

import base64
import httpx

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

body = {
    "model": "gpt-image-2",
    "prompt": "一只可爱的白色小猫，超写实摄影风格，柔和自然光，浅景深",
    "size": "1024x1024",
    "quality": "high",
    "output_format": "png"
}

resp = httpx.post(
    "http://10.0.88.12:7777/v1/images/generations",
    headers=headers,
    json=body,
    timeout=300
)
resp.raise_for_status()
data = resp.json()

with open("output.png", "wb") as f:
    f.write(base64.b64decode(data["data"][0]["b64_json"]))

状态与错误

常见返回状态如下，建议你在客户端做好错误提示与重试处理。

200 OK

请求成功

请求成功，返回图片 Base64 数据。

401 Unauthorized

鉴权失败

未携带有效 Bearer Key，或 Key 已失效。

400 Bad Request

参数错误

例如 `prompt` 为空，或 `model` 不是 `gpt-image-2`。

502 Bad Gateway

上游生图失败

通常表示上游生图服务异常，建议稍后重试。

赞助站点： https://api.dlapi.xyz/