Nano Banana logoNano Banana
API 介绍快速开始

API

GPT Image 2.5 API

图片

GPT Image 2.5 API 将 OpenAI 最先进的图片生成与编辑模型接入您的应用。支持通过文字生成图片或基于参考图片进行编辑，并提供灵活的宽高比以及 1K、2K、4K 输出。选择 flare，快速生成高质量的日常创意图片；选择 sunburst，满足更高的质量要求并进行精确图片编辑。

身份验证

Bearerstringheader必填

用于授权请求的 API Key

Body

application/json
modelstring必填
gpt-image-2-5
input.promptstring必填

描述您希望生成的图片，包括主体、构图、风格和光照。编辑图片时，请说明需要修改的内容，以及参考图片中需要保留的部分。首尾空白字符会被自动移除。

input.modestring可选

选择 GPT Image 2.5 的模型版本。flare 为默认模式，侧重生成速度，适合高质量的日常图片生成和快速迭代。sunburst 侧重更高的质量要求与编辑精度，适合需要准确修改参考图片的创作任务。

两种模式均支持文生图和图片编辑。省略 input.images 时使用文字生成图片，提供参考图片时进行编辑。比较两种模式时，建议使用相同的提示词、参考图片、宽高比和分辨率。

默认值: flare

flaresunburst
input.imagesstring[]可选

可选参考图片 URL 列表。仅支持可公开访问的 HTTPS 图片链接。文生图时可省略。

input.aspect_ratiostring可选

输出图片的宽高比。auto 由模型自动选择合适的构图。选择列表中的比例可控制图片格式，例如 1:1 方图、9:16 竖图或 16:9 横图。

默认值: auto

auto1:12:33:23:44:39:1616:921:9
input.resolutionstring可选

输出图片的分辨率档位。使用小写值 1k、2k 或 4k 选择对应档位。需要指定输出分辨率时，请显式设置此字段。

默认值: 2k

1k2k4k

请求示例

POST /api/v1/create
curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-5",
  "input": {
    "prompt": "一张未来感香蕉造型相机的电影级产品摄影"
  }
}'
POST /api/v1/create · HTTP 201
{
  "data": {
    "task_id": "task_example",
    "model": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

使用返回的任务 ID 轮询此 Endpoint，直到任务完成或失败。建议每 5 秒轮询一次，以获取最新任务状态。

POST /api/v1/check
{
  "task_id": "task_example"
}

响应

POST /api/v1/check 返回的任务状态。以下 ID、URL 和时间戳仅用于示例。

idstring必填

data.id 为任务标识，与查询请求中的 task_id 一致。

statusstring必填
completed 表示生成成功，data.data 包含生成结果；其他状态下 data.data 为 null。
failed_reasonstring可选

仅当 status 为 failed 时返回，用于说明失败原因。completed 和 processing 状态不包含此字段。

已完成 · completed

下载链接位于 data.data.results。

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

其他状态

processing 或 failed 状态下，data.data 为 null。以下以 failed 为例：只有 failed 才包含 failed_reason。processing 时继续轮询，failed 时停止轮询。

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

积分消耗

以下积分按单次请求生成一张图片计算。

以下积分按单次请求生成一张图片计算。
分辨率1K2K4K
单张图片123650

省略可选参数: 5 积分

请显式传入表格列出的 input 参数，以使用对应档位。一次生成多张图片时，积分消耗可能增加。

POST /api/v1/create 响应中的 credits 字段为该任务实际扣除的积分。