获取 Key 与确认模型
在 Google AI Studio 创建 Gemini API Key，并核对项目计费与模型可用性。创建 Key 不代表图片生成免费。密钥应保留在服务端环境变量中。 官方 Key 指南 ↗
- Nano Banana 2:
gemini-3.1-flash-image - Nano Banana Pro:
gemini-3-pro-image - Nano Banana 2.1:
gemini-nano-banana-2.1 - Nano Banana Lite:
gemini-3.1-flash-lite-image
Gemini 使用 https://generativelanguage.googleapis.com 与 /v1beta/models/{model}:generateContent 路径。渠道 base URL 和别名以各自文档为准。本站模型测试只支持 OpenAI 兼容的同步接口；原生 Gemini 与 fal 请使用下方 SDK。
官方 Gemini SDK 示例
安装 @google/genai。在服务端配置 GEMINI_API_KEY，切换模型时明确修改 GEMINI_IMAGE_MODEL。此示例使用 Gemini generateContent 协议。
import { GoogleGenAI } from '@google/genai';
import { writeFileSync } from 'node:fs';
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const response = await ai.models.generateContent({
model: process.env.GEMINI_IMAGE_MODEL || 'gemini-3.1-flash-image',
contents: 'Generate an image of a flower shop after rain.'
});
for (const part of response.candidates?.[0]?.content?.parts || []) {
if (part.inlineData?.data) {
const ext = part.inlineData.mimeType === 'image/jpeg' ? 'jpg' : 'png';
writeFileSync('result.' + ext, Buffer.from(part.inlineData.data, 'base64'));
}
}渠道示例：fal 使用自己的队列协议
安装 @fal-ai/client，在服务端配置 FAL_KEY。下方渠道别名与 Google 官方模型 ID 不同，它不使用 OpenAI 兼容的 /images/generations 接口。更换渠道前需核对渠道 API 文档。
import { fal } from '@fal-ai/client';
const result = await fal.subscribe('fal-ai/nano-banana-2', {
input: { prompt: 'A flower shop after rain.',
num_images: 1, resolution: '1K', aspect_ratio: '1:1' }
});
console.log(result.data);重试前排查错误
401 检查密钥与鉴权格式；403 检查权限与地区可用性；404 检查模型别名与 endpoint；429 检查额度与请求限制。超时可能发生在扣费后，重复提交前应查询任务状态。示例仅核对文档与语法，本轮未发送付费请求。
内容核对：2026-10-08 · 价格核验日期逐条列出；免费资格以链接中的渠道规则为依据。