图像生成 nano-banana

POST

/v1/images/generations

提示

default分组默认返回url格式。Gemini分组默认返回base64格式（更稳定），两个分组生图价格都一样的。
使用url格式返回，url有效性仅有数小时，需尽快下载url图片地址。

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

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

请求参数

Authorization

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

// 基础示例
{
    "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://maas.trainkr.cloud/v1/images/generations' \
--header 'Authorization: <api-key>' \
--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": 1745984918,
    "data": [
        {
            "b64_json": "iVBORw0KGgoAAAANSUhEUgAABAAAAAYACAI..."
        }
    ],
    "usage": {
        "input_tokens": 8,
        "input_tokens_details": {
            "image_tokens": 0,
            "text_tokens": 8
        },
        "output_tokens": 1308,
        "total_tokens": 1316
    }
}

🟠400请求参数错误

🟠401鉴权失败

🟠403无权限访问

🟠404资源不存在

🟠429请求过于频繁，请稍后重试

🔴500服务内部错误

修改于 2026-03-29 14:06:31

nano-banana参考尺寸

图像编辑 nano-banana

图像生成 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) 支持接口类型