NanoBanana 图像生成部署指南

通过NassaApi 中转站调用 Gemini 原生图像生成 API。

📋 简介

NanoBanana 是本站提供的 Gemini 图像生成 model 系列。使用本站 API Key 即可直接调用，无需科学上网、无需谷歌账号。

🎯 模型介绍

本站提供两个 NanoBanana 模型：

模型 ID	别名	说明
gemini-3-pro-image-preview	NanoBananaPro	追求画质、细节丰富
gemini-3.1-flash-image-preview	NanoBanana2	追求速度和性价比

💡 如何选择

• 追求画质：选 NanoBananaPro（Pro 版）
• 追求速度 / 性价比：选 NanoBanana2（Flash 版）

📐 支持的宽高比

两个模型均支持以下 10 种宽高比：

1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 5:4 · 4:5

📏 支持的分辨率

每种宽高比支持三种分辨率等级：

等级	用途
1K	快速预览
2K	推荐使用（画质 + 速度平衡）
4K	超高清（生成时间较长）

🔧 API 请求格式

基本请求结构

{
  "contents": [{
    "parts": [
      { "text": "您的图片描述" }
    ]
  }],
  "generationConfig": {
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "image_size": "2K"
    }
  }
}

参数说明

参数	可选值	说明
responseModalities	["IMAGE"]	返回类型
aspectRatio	见上方 10 种比例	宽高比
image_size	1K / 2K / 4K	分辨率等级

API 端点

POST https://api.nassaapi.xyzbeta/models/{模型ID}:generateContent

• NanoBananaPro：gemini-3-pro-image-preview
• NanoBanana2：gemini-3.1-flash-image-preview

📝 示例代码

cURL 示例

curl -X POST "https://api.nassaapi.xyzbeta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {"text": "一只可爱的小猫咪坐在花园里，油画风格，高清，细节丰富"}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "image_size": "2K"
      }
    }
  }'

Python 示例

import requests
import base64

API_KEY = "sk-你的密钥"
API_URL = "https://api.nassaapi.xyzbeta/models/gemini-3-pro-image-preview:generateContent"

payload = {
    "contents": [{
        "parts": [
            {"text": "一只可爱的小猫咪坐在花园里，油画风格，高清，细节丰富"}
        ]
    }],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "imageConfig": {
            "aspectRatio": "16:9",
            "image_size": "2K"
        }
    }
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

response = requests.post(API_URL, headers=headers, json=payload, timeout=600)

if response.status_code == 200:
    data = response.json()
    image_base64 = data["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
    with open("output.png", "wb") as f:
        f.write(base64.b64decode(image_base64))
    print("图片已保存为 output.png")
else:
    print(f"请求失败: {response.status_code}")
    print(response.text)

⏱️ 性能建议

推荐超时时间

分辨率	推荐 timeout
1K	60 秒
2K	120 秒
4K	600 秒（10 分钟）

带宽注意

• 4K 图像单张约 2–5 MB
• Base64 编码后体积 +33%
• 批量生成建议流式下载

⚠️ 注意事项

• 🔐 保管好 API Key，泄露后请立即在控制台删除并新建
• 💰 图像生成按张计费，4K > 2K > 1K
• 🎨 Prompt 越具体效果越好（风格、构图、光线、细节全都写）
• ⏱️ Pro 版比 Flash 版慢 2–3 倍，但质感更精细