gpt-image-2 图片生成 SDK

用途：把本文件发给任意 AI 工具（Claude / ChatGPT / Codex 等），AI 即可调用 naapi.cc 的 gpt-image-2 生成图片。
版本：v1
时间：2026-08-02
作者：钠 API 鈉 API | ナトリウム API - 王曉婷
归属：https://naapi.cc/ - 中國台灣鈉雲網路科技 · P.R.C Taiwan NaCloud Network Technology Co., Ltd.
本文件不含密钥；调用方必须自行写入 API Key。

1. 快速开始（curl）

2. 鉴权

Base URL：https://naapi.cc/v1

请求头：Authorization: Bearer <API_KEY>

API Key 属于用户私有凭据，不得写入代码、文档、日志或对话记录。

3. 请求协议（同步，一次请求直接出图）

POST https://naapi.cc/v1/images/generations
Content-Type: application/json
Authorization: Bearer <API_KEY>

请求体：

{
  "model": "gpt-image-2",
  "prompt": "一个纯白背景上的蓝色小圆",
  "size": "1024x1024",
  "quality": "low",
  "n": 1
}

字段说明：

字段	必填	说明
`model`	是	固定 `gpt-image-2`
`prompt`	是	图片内容描述
`size`	否	`1024x1024`（默认）、`3840x2160`（4K，实测支持）等
`quality`	否	`low`（省钱）/ `high`；建议默认 `low`
`n`	否	生成张数，默认 1

响应（HTTP 200，同步，约 30 秒内返回）：

{
  "created": 1785631919,
  "model": "gpt-image-2",
  "data": [
    { "b64_json": "iVBORw0KGgoAAAANSUhEUg..." }
  ]
}

图片在 data[0].b64_json（Base64，PNG）。

把 Base64 解码写入文件即可得到图片。

4. 给 AI 的规则

生成前向用户确认 prompt 和尺寸（4K 更贵）。

默认使用 "quality": "low" 省钱，除非用户明确要求高质量。

同步接口：一次请求直接返回图片，不需要轮询。

失败时读取 error.message 告知用户，不要盲目重试。

5. 错误处理

现象	处理
400 / 401 / 429	按 `error.message` 提示用户，不重试同参数
网络超时（curl 28）	可重试一次；连续失败则告知用户稍后再试
余额不足	提示用户充值

6. Python 样例代码

依赖：pip install requests。API Key 只从环境变量 NAAPI_API_KEY 读取。

gpt-image-2 图片生成 SDK

1. 快速开始（curl）#

2. 鉴权#

3. 请求协议（同步，一次请求直接出图）#

4. 给 AI 的规则#