图像生成 nano-banana

接口类型	端点	说明
OpenAI聊天接口	/v1/chat/completions	支持流、非流连续对话、不支持尺寸
OpenAI图片生成接口	/v1/image/generations	文生图、支持尺寸
OpenAI图片编辑接口	/v1/image/edits	图生图（支持传入1~6张图）、支持尺寸

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

prompt

string

提示词

必需

所需图像的文本描述。最大支持输入32,768 Tokens。

model

enum<string>

模型名称

必需

nano-banana-pro就是 gemini-3-pro-image-preview模型，使用nano-banana系列命名的模型，支持url输出。

枚举值:

nano-banana-pronano-banana-pro-2knano-banana-pro-4knano-bananagemini-3.1-flash-image-previewgemini-3.1-flash-image-preview-0.5kgemini-3.1-flash-image-preview-2kgemini-3.1-flash-image-preview-4kgemini-3-pro-image-previewgemini-2.5-flash-image

示例:

nano-banana

response_format

enum<string>

数据类型

可选

返回的数据类型，默认base64

枚举值:

b64_jsonurl

size

string

图片大小

可选

2.5系列可输入尺寸或比例

Aspect ratio	Resolution
1:1	1024x1024
2:3	832x1248
3:2	1248x832
3:4	864x1184
4:3	1184x864
4:5	896x1152
5:4	1152x896
9:16	768x1344
16:9	1344x768
21:9	1536x672

注意：gemini-3+系列模型请使用以下值 1K、2K、4K
gemini-3.1-flash-image-preview额外支持0.5K

aspect_ratio

string

图片比例

可选

注意：仅

gemini-3+系列模型支持该参数。输入具体的图片比例
示例：

2:3`

示例

// 基础示例
{
    "model": "nano-banana",
    "prompt": "一张逼真的高分辨率照片，拍摄的是繁忙的城市街道",
    "size": "2:3"
}
// nano-banana-pro(gemini-3-pro-image-preview)
{
    "model": "nano-banana-pro",
    "prompt": "一张逼真的高分辨率照片，拍摄的是繁忙的城市街道",
    "size": "4K",
    "aspect_ratio": "2:3"
}
// 名称携带-2k、-4k，无需传aspect_ratio
{
    "model": "nano-banana-pro-2k",
    "prompt": "一张逼真的高分辨率照片，拍摄的是繁忙的城市街道",
    "size": "2:3",
    "response_format": "url"
}

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.pawmaas.com/v1/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '// 基础示例
{
    "model": "nano-banana",
    "prompt": "一张逼真的高分辨率照片，拍摄的是繁忙的城市街道",
    "size": "2:3"
}
// nano-banana-pro(gemini-3-pro-image-preview)
{
    "model": "nano-banana-pro",
    "prompt": "一张逼真的高分辨率照片，拍摄的是繁忙的城市街道",
    "size": "4K",
    "aspect_ratio": "2:3"
}
// 名称携带-2k、-4k，无需传aspect_ratio
{
    "model": "nano-banana-pro-2k",
    "prompt": "一张逼真的高分辨率照片，拍摄的是繁忙的城市街道",
    "size": "2:3",
    "response_format": "url"
}'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object]

必需

b64_json

string

可选

usage

object

必需

input_tokens

integer

必需

input_tokens_details

object

必需

output_tokens

integer

必需

total_tokens

integer

必需

示例

{
    "created": 1745984918,
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAYACAI..."
        }
    ],
    "usage": {
        "input_tokens": 8,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 8
        },
        "output_tokens": 1308,
        "total_tokens": 1316
    }
}

图像生成 nano-banana

nano-banana (gemini-2.5-flash-image/gemini-3-pro-image-preview) 支持接口类型#

请求参数

请求示例代码

返回响应

nano-banana (gemini-2.5-flash-image/gemini-3-pro-image-preview) 支持接口类型