Nano Banana 使用指南

Nano Banana 用于文字生成图片，也可以上传图片进行修改。想直接出图，先用 Studio；需要接到自己的程序里，再看后面的 API 示例。

在 Studio 中使用

打开 AruHub Studio，点击左下角设置。
在 图片模型 中选择 bunana；协议选 Google，Base URL 填 https://api.aruhub.com。
粘贴自己的 API Key，点击 获取模型，选择图片模型并保存。
回到 生图工作台，选择 bunana 渠道，输入想画的内容，再选择比例与清晰度。
点击发送，等待图片完成后下载。要修改已有图片，先上传参考图，再描述想改的地方。

例如：

一张白色陶瓷咖啡杯的产品照片，浅灰背景，柔和自然光，杯身正面印着“早安”，方形构图。

普通生图只需要配置图片模型。使用 Studio 的 Agent 对话功能，还需要配置文本模型。

模型怎么选

名称	AruHub 常见模型 ID
Nano Banana 2	`gemini-3.1-flash-image-preview`
Nano Banana Pro	`gemini-3-pro-image-preview`
Nano Banana 2.1	`gemini-nano-banana-2.1`

以当前密钥“获取模型”的结果为准。 模型是否可用、支持的分辨率和计费，以模型列表与渠道说明为准。

填写信息速查

字段	填什么
协议	Google / Gemini 原生协议
Base URL	`https://api.aruhub.com`
API Key	自己的 AruHub 密钥
模型 ID	从“获取模型”返回的结果中选择

图片请求的完整路径是 /v1beta/models/模型ID:generateContent。Base URL 中不用预先添加 /v1 或 /v1beta。

开发者：通过 API 生成一张图片

以下是与 Studio 相同的 Gemini 原生请求格式。先把密钥与模型 ID 换成自己的值，在 macOS / Linux 终端执行：

bash

curl "https://api.aruhub.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "白色陶瓷咖啡杯，浅灰背景，柔和自然光"}]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }' -o response.json

响应中的图片位于 candidates[].content.parts[].inlineData。其中 data 是 Base64 数据，mimeType 表示图片类型；这不是一个可直接打开的图片网址。

将下面代码保存为 save_image.py，和 response.json 放在同一目录，再运行 python save_image.py：

python

import base64
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8"))
count = 0
for candidate in response.get("candidates", []):
    for part in candidate.get("content", {}).get("parts", []):
        image = part.get("inlineData") or part.get("inline_data")
        if not image:
            continue
        mime = image.get("mimeType") or image.get("mime_type", "")
        suffix = {"image/png": ".png", "image/jpeg": ".jpg",
                  "image/webp": ".webp"}.get(mime, ".bin")
        count += 1
        Path(f"image-{count}{suffix}").write_bytes(
            base64.b64decode(image["data"])
        )
print(f"已保存 {count} 张图片")

Gemini 的图片输入、输出结构可参考 Google 官方图片生成文档。本页的域名与鉴权使用 AruHub 接入方式。

常见问题

问题	检查方法
401 / 密钥无效	检查密钥是否完整、是否有该模型权限
获取不到模型	检查协议是否为 Google、地址是否正确、密钥分组是否支持图片模型
模型不存在	使用“获取模型”返回的完整 ID，不要直接填 `nanobanana`
返回 JSON，没有图片文件	在程序中解码 `inlineData.data`，或直接使用 Studio 下载
提示内容审核未通过	根据提示修改请求内容；这类错误不等于接口地址配置错误

也可以查看 GPT Image 2 或接口地址与密钥。

Nano Banana 使用指南 ​

在 Studio 中使用 ​

模型怎么选 ​

填写信息速查 ​

常见问题 ​

Nano Banana 使用指南

在 Studio 中使用

模型怎么选

填写信息速查

常见问题