Nano Banana 2.1 API

Gemini API 的模型 ID 是 gemini-nano-banana-2.1。在 Google AI Studio 获取密钥后,可以在服务器上通过 generateContent 发起请求并保存返回的图片。下面的示例分别演示文生图和参考图编辑。

模型
0/4000
画面比例
分辨率

基础 15 + 参考图 0 + 提示词 0 = 15 积分

参考图和较长的提示词可能增加积分,生成前会显示完整费用。

黄昏时分温馨的咖啡馆,35mm 胶片照片,暖光透过窗户,窗上的霓虹灯写着 "OPEN LATE"

示例黄昏时分温馨的咖啡馆,35mm 胶片照片,暖光透过窗户,窗上的霓虹灯写着 "OPEN LATE"

真实效果

在生成器中调好的提示词

在生成器中调好的提示词

用 Nano Banana 2.1 生成的 3D 吉祥物。可以直接把同样的提示词用在下面的请求里。

这张图使用的提示词 · 1:1

A friendly 3D banana mascot wearing round sunglasses and headphones, studio lighting, pastel yellow background, animated film style

本站提供什么

可以在本站的网页生成器里用站内积分测试提示词。要从自己的应用发起调用,请在 Google AI Studio 中为已启用结算的项目创建密钥。Google 会向该密钥所属的项目计费。

关键参数

responseModalities 必须包含 IMAGE。imageConfig.aspectRatio 支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3、5:4、4:5、21:9,以及 4:1、8:1、1:4、1:8 长条比例。imageConfig.imageSize 可选 1K、2K、4K。做编辑时,把最多 14 张参考图作为 inlineData 放在文字部分之前。

响应中的 candidates 包含 parts,图片的 base64 数据位于 inlineData。保存结果时跳过标记为 thought 的中间图。如果没有返回图片,可以查看 promptFeedback.blockReason 和 candidate.finishReason。

请求示例

先在服务器环境中设置 GEMINI_API_KEY。curl 和 Node.js 示例都会通过 x-goog-api-key 请求头向 Google 发送密钥。

用 curl 做文生图。aspectRatio 的取值与生成器一致,imageSize 为 1K、2K 或 4K。
curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-nano-banana-2.1:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{ "text": "A cozy coffee shop at golden hour, 35mm film photo" }]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": { "aspectRatio": "3:2", "imageSize": "2K" }
    }
  }'
用 Node.js 发起同样的调用,并把第一张最终图片保存到本地。
import { writeFile } from 'node:fs/promises';

const model = 'gemini-nano-banana-2.1';
const res = await fetch(
  `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-goog-api-key': process.env.GEMINI_API_KEY,
    },
    body: JSON.stringify({
      contents: [{ role: 'user', parts: [{ text: 'A friendly 3D banana mascot, studio lighting' }] }],
      generationConfig: {
        responseModalities: ['TEXT', 'IMAGE'],
        imageConfig: { aspectRatio: '1:1', imageSize: '1K' },
      },
    }),
  }
);
if (!res.ok) throw new Error(await res.text());

const data = await res.json();
const parts = data.candidates?.[0]?.content?.parts ?? [];
// Skip interim "thought" images, keep the final one.
const image = parts.find((p) => p.inlineData?.data && !p.thought);
if (!image) throw new Error('no image returned');

await writeFile('mascot.png', Buffer.from(image.inlineData.data, 'base64'));
编辑:先把照片作为 inlineData 放在最前,再写指令。googleSearch 工具是可选的。
{
  "contents": [{
    "role": "user",
    "parts": [
      { "inlineData": { "mimeType": "image/jpeg", "data": "<base64 of your photo>" } },
      { "text": "Replace the background with a minimalist white studio. Keep the person exactly the same." }
    ]
  }],
  "generationConfig": {
    "responseModalities": ["TEXT", "IMAGE"],
    "imageConfig": { "aspectRatio": "4:5", "imageSize": "2K" }
  },
  "tools": [{ "googleSearch": {} }]
}

操作步骤

  1. 01

    先调提示词

    用本页的生成器。在写代码之前先确定提示词、比例和分辨率。

  2. 02

    创建 Gemini API Key

    在 Google AI Studio 创建密钥并放在服务器端,不要放进浏览器代码。

  3. 03

    发送请求并保存图片

    解码 base64 数据并存到你自己的存储里,明确处理错误和被拦截的提示词。

技巧

  • 密钥只放服务器

    在后端调用 API,再给前端暴露你自己的接口。

  • 设置超时和重试

    图像生成比普通 API 调用慢。使用较长的超时,并且只对临时性错误重试。

  • 留意 4K 的成本

    像网页生成器那样,1K 出草稿,4K 出终稿。

常见问题

NanoBanana 2.1 提供 API 吗?
不提供。本站是用积分的网页生成器。要在代码里调用 Nano Banana 2.1,请用你自己的 Key 调用 Gemini API。
该用哪个模型 ID?
填写 gemini-nano-banana-2.1。用 REST 调用 generateContent 时,模型 ID 在请求地址的 models/ 和 :generateContent 之间。
API 怎么输出 4K?
把 generationConfig.imageConfig.imageSize 设为 "4K"。可选值是 1K、2K 和 4K。
可以通过 API 编辑已有照片吗?
可以。把照片作为 inlineData 放在前面,再跟上文字指令。上面的示例展示了结构。

生成你的第一张 Nano Banana 2.1 图片

描述你想生成的第一张图片,生成前即可查看完整积分费用。