gpt-image-2 图像生成 API

本文说明如何通过 OPENNAVE API 调用 gpt-image-2 生成 1K、2K 和 4K 图像。成功响应中的图像以 Base64 PNG 数据返回。

接口概览

项目	值
Base URL	`https://api.opennave.top/v1`
请求地址	`POST /images/generations`
模型	`gpt-image-2`
认证	`Authorization: Bearer YOUR_OPENNAVE_API_KEY`
单价	$2.00 / 张
超时建议	300 至 600 秒

API Key 只能保存在服务端环境变量或密钥管理服务中，不要写入浏览器代码、公开仓库或移动端包。

快速调用

curl --request POST \
  --url 'https://api.opennave.top/v1/images/generations' \
  --max-time 600 \
  --header 'Authorization: Bearer YOUR_OPENNAVE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "gpt-image-2",
    "prompt": "一台悬浮在纯白摄影棚中的未来感精密设备，黑色金属材质，青色光线，商业产品摄影",
    "n": 1,
    "size": "2048x2048",
    "quality": "high",
    "output_format": "png",
    "background": "opaque"
  }'

请求参数

字段	类型	说明
`model`	string	必填，固定使用 `gpt-image-2`。
`prompt`	string	必填，描述主体、环境、构图、材质、光线与限制。
`n`	integer	可选，生成数量；费用按实际生成张数累加。
`size`	string	可选，输出尺寸。
`quality`	string	可选，`low`、`medium`、`high` 或 `auto`。
`output_format`	string	可选，推荐 `png`。
`background`	string	可选，推荐 `opaque` 或 `auto`。

尺寸规格

以下尺寸已经通过接口验证：

档位	方图	横图	竖图
1K	`1024x1024`	`1536x1024`	`1024x1536`
2K	`2048x2048`	`2048x1152`	`1152x2048`
4K	不适用	`3840x2160`	`2160x3840`

4K 文件体积较大，客户端超时应设置为 600 秒，且不要在浏览器中直接处理超大的 Base64 数据。

响应处理

成功响应中的数据位于 data[0].b64_json。服务端应解码后保存为图片文件或上传到对象存储，再向业务客户端返回受控访问 URL。

json

{
  "created": 1785302608,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

Python 解码示例：

python

import base64
from pathlib import Path

image_bytes = base64.b64decode(result["data"][0]["b64_json"])
Path("gpt-image-2.png").write_bytes(image_bytes)

响应未必回显请求的 size 和 quality，如需验证尺寸，应读取生成文件的实际像素。

计费与错误处理

当前价格为每张成功生成图像 $2.00，尺寸和质量不改变单张价格：费用 = n × $2.00。

情况	建议处理
400	检查模型名、JSON、尺寸字符串和必填参数。
401	检查 Authorization 和 API Key。
429	降低并发，使用指数退避。
5xx	保存完整错误体，短暂等待后有限次重试。
客户端超时	2K、4K 生成时间较长，超时建议设为 600 秒。

生产环境应限制单次生成数量、并发和每日额度；记录模型、尺寸、质量、HTTP 状态与文件哈希，但不要将完整 Base64 响应或 API Key 写入日志。

查看更多模型 API

gpt-image-2 图像生成 API ​

接口概览 ​

快速调用 ​

请求参数 ​

尺寸规格 ​

响应处理 ​