Nano Banana 2.1 API
Gemini API 的模型 ID 是 gemini-nano-banana-2.1。在 Google AI Studio 获取密钥后,可以在服务器上通过 generateContent 发起请求并保存返回的图片。下面的示例分别演示文生图和参考图编辑。
基础 15 + 参考图 0 + 提示词 0 = 15 积分
参考图和较长的提示词可能增加积分,生成前会显示完整费用。

示例黄昏时分温馨的咖啡馆,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 -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" }
}
}'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'));{
"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": {} }]
}操作步骤
- 01
先调提示词
用本页的生成器。在写代码之前先确定提示词、比例和分辨率。
- 02
创建 Gemini API Key
在 Google AI Studio 创建密钥并放在服务器端,不要放进浏览器代码。
- 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 图片
描述你想生成的第一张图片,生成前即可查看完整积分费用。