AIRI 配置 Nano BananaGoogle Gemini 图像生成完整指南API Key、模型与分辨率设置【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi本篇技术指南讲解如何在 AIRI 中启用并配置 Nano BananaGoogle AI Studio 原生 Gemini 图像生成能力从获取 API Key、在Settings → Providers → Artistry → Nano Banana中填入凭据并选择默认模型与分辨率到在Settings → Modules → Artistry中激活「Nano Banana (Preview)」提供方再到结合聊天工具调用验证整条链路是否可用。读完本文你将掌握 Nano Banana 提供方的完整配置流程、底层 API 调用原理含源码级证据以及常见故障的排查思路。Nano Banana 是什么为什么选择它Nano Banana 是 AIRI 内置的 Artistry图像生成提供方之一底层使用 Google AI Studio 的 Gemini 图像模型。如果用户已经持有 Google AI Studio 的 API Key就可以直接复用 AIRI 内置的 Gemini 图像模型与分辨率选项1K / 2K / 4K无需额外搭建本地推理环境也无需申请其他图像服务账号——这是它相比 ComfyUI、Replicate 等其他 Artistry 提供方最直接的优势。从仓库结构看AIRI 的 Artistry 模块是一套多提供方抽象架构抽象接口定义在 providers/base.ts其中ArtistryProvider接口统一了generate、getStatus、cancel、initialize、setJobCallback等方法各提供方ComfyUI、Replicate、Nano Banana实现同一接口后注册到主进程的提供方注册表见 artistry-bridge.tsexport const artistryProviders new Mapstring, ArtistryProvider() artistryProviders.set(comfyui, new ComfyUIProvider()) artistryProviders.set(replicate, new ReplicateProvider()) artistryProviders.set(nanobanana, new NanoBananaProvider())Nano Banana 提供方在仓库中的显示名称为Nano Banana (Google AI Studio)对应实现类为NanoBananaProvider见 providers/nanobanana.ts。第一步获取 Google AI Studio API Key登录 Google AI Studio 的API Keys管理页面点击创建Create生成一个新的 API Key。确认所选图像模型如 Gemini 3.1 Flash Image 等在当前账号与所属地区可用——Google 的预览模型通常存在区域与配额限制这一步骤决定了后续调用是否会返回 403/429 类错误。复制 Key 并妥善保存在安全的位置配置完成后即可粘贴到 AIRI 中。::: warning API Key 安全须知 切勿将 API Key 提交到版本库、包含在截图里或分享给任何人。一旦 Key 疑似泄露应立即在 Google AI Studio 中吊销并重新创建。Key 是你图像生成费用的凭据泄露即意味着被他人冒用消耗配额。 :::第二步在 AIRI 中配置 Nano Banana配置入口为Settings → Providers → Artistry → Nano Banana对应仓库中的设置页源码 nanobanana.vue。该页面提供三个配置项配置项说明可选值 / 默认值API Key你的 Google AI Studio API Key输入框为密码类型typepassword占位符形如AIpk...必填默认空Preferred Model默认模型使用的 Gemini 图像预览模型gemini-3.1-flash-image-preview默认、gemini-3-pro-image-preview、gemini-2.5-flash-imageDefault Resolution默认分辨率生成图像的默认目标分辨率1K默认、2K、4K三个模型选项在设置页中以modelOptions计算属性硬编码见 nanobanana.vue在 i18n 文案中分别对应 Nano Banana 2 (Gemini 3.1 Flash Image)、Nano Banana Pro (Gemini 3 Pro Image)、Nano Banana (Gemini 2.5 Flash Image)见 en/settings.yaml。配置的持久化与默认值这些配置项通过 Pinia storeuseArtistryStore持久化存储键与默认值定义在 stores/modules/artistry.tsconst nanobananaApiKey useLocalStorageManualResetstring(artistry-nanobanana-api-key, , persistenceOptions) const nanobananaModel useLocalStorageManualResetstring( artistry-nanobanana-model, gemini-3.1-flash-image-preview, persistenceOptions, ) const nanobananaResolution useLocalStorageManualResetstring( artistry-nanobanana-resolution, 1K, persistenceOptions, )对应地Electron 主进程侧以 valibot schema 定义了同名的持久化配置结构configs/artistry.ts默认模型同样是gemini-3.1-flash-image-preview、默认分辨率1K。也就是说即使你不手动选择模型与分辨率AIRI 也会自动使用这两个默认值发起请求。另外注意store 中configured计算属性规定当 activeProvider 为nanobanana时只有 API Key 非空才算配置完成见 artistry.ts若 Key 为空界面会判定提供方未配置。第三步验证配置并触发图像生成配置好提供方后按以下步骤验证整条链路打开Settings → Modules → Artistry在提供方卡片中选择Nano Banana (Preview)。该卡片仅在自定义提供方未被禁用时显示isCustomProvidersDisabled()为假见 modules/artistry.vue在 i18n 中其显示名为 Nano Banana (Preview)见 en/settings.yaml。在Settings → Modules → Consciousness中选择一个**支持工具/函数调用tool/function calling**的对话模型。这是关键前提AIRI 需要借助对话模型解析用户意图并触发 Artistry 工具调用最终把生成请求派发给 Nano Banana 提供方。回到聊天界面让 AIRI 生成一张非敏感图片。如果聊天中返回了图片即证明API Key → 模型 → 分辨率 → 工具调用整条链路全部打通。底层发生了什么一次 Nano Banana 生成请求的完整调用链从源码可以完整还原这次「验证」背后的执行路径触发拦截主进程通过 artistry-bridge.ts 中的handleArtistryTrigger拦截组件更新检测到componentName为comfy/artistry且状态为generating时开始派发生成任务。防重复保护bridge 用「mode remixId prompt」生成指纹triggerFingerprint同一组件实例的完全相同请求不会重复发起避免响应式 UI 循环导致意外扣费源码注释明确此为计费保护设计。初始化提供方provider.initialize(activeGlobals)被调用NanoBananaProvider.initialize从配置中读取nanobananaApiKey兼容config.apiKey字段、nanobananaModel、nanobananaResolution并记录日志[Nano Banana] Initialized. API Key present: ...见 providers/nanobanana.ts。发起 HTTP 请求generate方法拼装 REST 请求并调用 Google Generative Language API 的generateContent端点const url https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key${this.apiKey} // ... body: JSON.stringify({ contents: [{ parts: generationParts }], generationConfig: { imageConfig: { aspectRatio: 1:1, imageSize: resolution } }, })见 providers/nanobanana.tsmodel取自请求参数或初始化时的默认模型resolution1K/2K/4K映射到imageConfig.imageSizeaspectRatio固定为1:1若请求携带源图像request.extra.image或providerOptions.image且已剥离base64,前缀会以inline_data形式追加到 parts 中支持图生图/编辑场景providers/nanobanana.ts。结果解析与状态上报从响应candidates[0].content.parts中查找第一个带inlineData.data的图像部分将其封装为data:${mimeType};base64,${data}的 data URL并把任务状态更新为succeeded且progress: 100providers/nanobanana.ts。任务失败时状态置为failed并附带错误信息任务完成后 10 秒会自动清理 callback 与结果缓存防止内存泄漏providers/nanobanana.ts。等待结果NanoBananaProvider实现了setJobCallbackbridge 走「callback-based wait」分支在 5 分钟超时时间内等待succeeded/failed回调artistry-bridge.ts。这套调用链意味着只要 API Key 有效、模型可用即使不通过聊天任何内部组件如 Character Card 的 Artistry 卡片也能通过 headless 接口artistryGenerateHeadless复用同一生成管线该 IPC 地址定义在 stage-shared/artistry.ts。常见故障排查原文档给出的排查要点如下结合源码可进一步定位现象可能原因处理建议认证失败HTTP 401/403 类错误API Key 无效、过期或已被吊销核对 Key 是否完整正确必要时在 Google AI Studio 重新生成图像生成失败Google AI Studio 账号/地区不支持所选模型、模型当前状态异常、配额耗尽检查账号与地区可用性查看模型当前状态可先切换到 1K 分辨率降低配额消耗或换用其他可用模型如从gemini-3-pro-image-preview切到gemini-2.5-flash-image提示 Nano Banana API Key not configured提供方已选择但 API Key 为空回到Settings → Providers → Artistry → Nano Banana填入 Keygenerate方法在 Key 缺失时会直接抛错providers/nanobanana.ts响应中没有图片数据API 返回异常或模型输出被过滤错误信息 No image data returned from Nano Banana 会以failed状态回传providers/nanobanana.ts建议换提示词或换模型重试排查时可留意主进程日志NanoBananaProvider使用useLogg(providers-nanobanana)输出[Nano Banana]前缀日志bridge 侧则输出[Artistry Bridge]、[Headless]前缀日志包含初始化是否成功、API Key 是否存在、作业状态轮询与失败原因是定位问题的最直接线索。小结Nano Banana 为已持有 Google AI Studio API Key 的 AIRI 用户提供了一条零额外部署成本的图像生成路径。整个配置只需三步获取 API Key → 在 Providers 页填入并选择模型/分辨率 → 在 Modules 页激活 Nano Banana (Preview)。其底层由NanoBananaProvider直连 Google Generative Language API 的generateContent端点以1:1宽高比和所选分辨率1K/2K/4K生成图像并通过统一的 ArtistryProvider 接口无缝接入 AIRI 的聊天工具调用与卡片生成管线。相关设置持久化于artistry-nanobanana-*存储键与 configs/artistry.ts 配置文件中全部配置均可通过Settings → Providers → Artistry → Nano Banana界面完成无需修改任何代码。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考