Name: nano-banana-2
Author: prime-skills/runcomfy-agent-skills

1实现原理 · 为什么它能做到

单模型专用型（非 router）：整个文档围绕一个端点 `google/nano-banana-2/text-to-image`，用『字段级 schema + 分级分辨率 + 提示词语法』把该模型的使用方法一次讲透。

nano-banana-2/SKILL.md

### `google/nano-banana-2/text-to-image`

注：与 video-edit/image-edit 的多模型路由不同，nano-banana-2 是『单模型深挖』文档；它把『选哪个模型』的责任前移成一张 When-to-pick 对比表（对 Nano Banana Pro / GPT Image 2 / Flux 2 / Seedream 5），而调用面只有一条 CLI。

能力由参数表实现：num_images（1–4 批量 ideation）、resolution 四档（0.5K/1K/2K/4K 定价分层）、seed 复现、aspect_ratio 11 值、safety_tolerance（1 严格–6 宽松）、enable_web_search、limit_generations 全部以『默认值 + 枚举 + 使用提示』内嵌。

nano-banana-2/SKILL.md

| `safety_tolerance` | int | no | 4 | 1 (strict) – 6 (permissive). |

注：『safety-tolerance dial』被直接暴露给 agent：可按用途把内容过滤放宽/收紧；同表 `resolution` 注明 0.5K (drafts)/2K (final)/4K (max)，对应 description 所述『resolution-tier pricing』的省钱策略。

提示词价值主张 = 图内排版文字与构图可预测：正文给出 subject-first 语法 + 逐字引用文本的写法，把『文字渲染不可控』变成可操作的 prompt 纪律。

nano-banana-2/SKILL.md

**Exact text quoting for in-image typography.** "The label reads 'AURA' in clean bold sans-serif, centered, white on black" — quote the literal characters. Specify placement and font style. Don't say "with the brand name on it" and hope.

注：这是本 skill 相对『裸调模型』的核心增量：subject-first 声明式语法（`Front-load subject; trail with directives`）+ 引号内逐字文本 + 固定 seed 迭代 + 风格不冲突（1–2 anchors）。

web 接地作为可选开关而不是默认行为：enable_web_search=false 默认关，文档约束只在提示词点名时事/实体时才开，并明示代价（latency + cost）。

nano-banana-2/SKILL.md

**Web-grounding, sparingly.** Turn on `enable_web_search` only when the prompt names current events / real entities. Adds latency + cost; off by default.

注：这一纪律同时是隐私/成本提示：一旦打开，提示词会在模型服务端参与联网检索。

边界条件明示：分辨率四档外与 11 个宽高比外的取值会 422；编辑类需求被明确导向 sibling 的 nano-banana-edit（换用 /edit 端点）。

nano-banana-2/SKILL.md

- Asking for resolutions outside the 4 tiers → 422.

注：同一 Anti-patterns 列表还有 `Non-quoted in-image text → unpredictable rendering`；正文末段 `For image edit (preserve subject + apply changes), see the sibling [nano-banana-edit](../nano-banana-edit) skill.` 形成 t2i↔i2i 的家族互链。

执行委托 runcomfy CLI：`runcomfy run google/nano-banana-2/text-to-image --input '{...}' --output-dir`，CLI POST 到固定 Model API URL、轮询并下载产物。

nano-banana-2/SKILL.md

The skill invokes `runcomfy run google/nano-banana-2/text-to-image` with a JSON body matching the schema. The CLI POSTs to `https://model-api.runcomfy.net/v1/models/google/nano-banana-2/text-to-image`, polls the request, fetches the result, and downloads any `.runcomfy.net`/`.runcomfy.com` URL into `--output-dir`.

注：nano-banana-2 是五个被侦查文件中唯一在 How-it-works 给出完整 API URL 的（其余用域名级描述）——端点契约最明确。

2核心能力

01flash-tier 快速 t2i：0.5K 草稿 → 2K 定稿的分级出图策略

02单请求 4-up 批量 ideation（num_images=4 + 竖版宽高比）

03图内排版文字可预测渲染（逐字引用 + 位置/字体约束语法）

04web-grounded 时事/实体出图（enable_web_search 开关）

05seed 锁定的可复现变体对比

06safety 容忍度拨盘与单轮生成限制（safety_tolerance / limit_generations）

07跨家族选型导流：与 Nano Banana Edit / Pro / GPT Image 2 / Flux 2 / Seedream 5 的边界

3外部依赖

类型	依赖
cli	runcomfy（@runcomfy/cli 官方 CLI）
package	@runcomfy/cli（npm 全局安装）
api	Google Nano Banana 2 文生图端点（RunComfy Model API 托管）
network	生成结果下载白名单
network	enable_web_search 联网检索（模型服务端执行）
network	RunComfy 模型页 / 文档站（引用链接）

4风险提醒风险提醒：橙色 · 评估后使用

风险提醒：橙色 · 评估后使用

提示词（可能含未发布品牌/营销文案）上送第三方云生成，且 web 检索选项会扩大数据流 — enable_web_search 后端与数据保留政策文档未说明；涉密创意素材需自评。
执行面与供应链仓外（CLI、Model API、npm 包） — 文档转述的 CLI 行为（token 0600、2 GiB、无 shell 展开）无法在本仓库证实。
safety_tolerance 放权旋钮可能被误调高，产出不受控内容 — 默认 4，上限 6（permissive）；skill 未对调高场景附加约束说明。
效果宣称无仓内证据（verified samples、sharp output） — 与同家族一致，营销话术层；实际出图质量取决于模型当前版本与 RunComfy 托管配置。
命名模糊的触发面：『Nano Banana』不带版本号时由 agent 猜 Pro/2 — 文档给了默认规则（人像 Pro / 其余 2），但『人像』判断仍属 LLM 主观分类，可能选错档位多花钱。

风险提醒：橙色，评估后使用。按本次统一分档准则：运行时驱动第三方 npm 包/CLI @runcomfy/cli，该 CLI 每次调用读取用户 RunComfy 凭证（~/.config/runcomfy/token.json 或 RUNCOMFY_TOKEN 环境变量）——命中『调第三方 npm/CLI 且可能读配额/密钥 → orange』；执行面（CLI、Model API、token 读取）全部仓外，文档转述（0600、2 GiB 上限、无 shell 展开）无法在本 pin 证实，按『拿不准取高一档』定橙。另存在网络外发：提示词（可能含品牌/未发布素材描述）经 model-api.runcomfy.net 上送第三方云生成；enable_web_search=true 时提示词还参与模型服务端联网检索（检索后端与数据保留政策文档未说明）。skill 本体纯 markdown、无脚本、无混淆、无隐藏端点，未触红档。

5第二遍独立确认

[ok] 端点 ID 与完整 URL 一致 — description/标题用 `google/nano-banana-2/text-to-image`，How-it-works 给出同路径完整 URL，无拼写漂移。
[ok] safety_tolerance / limit_generations / enable_web_search 字段存在且默认值自洽 — safety 默认 4、limit_generations 默认 true、web_search 默认 false，正文纪律（sparingly、off by default）与默认值一致。
[unlocatable] enable_web_search 的检索后端与数据流 — 文档只给 'Adds web grounding (extra cost + latency)'，未指明由谁检索、是否外发提示词给第三方检索服务——仓内无法定位，标记待补。
[unlocatable] 『sample prompts (verified to produce strong results)』宣称 — 三个样例提示词的 'verified' 无仓内评测数据，无法复核验证过程。
[ok] 与 nano-banana-edit 的 sibling 互链 — 相对链接 `../nano-banana-edit` 在仓库内真实可达（nano-banana-edit/SKILL.md 存在），且 nano-banana-edit 反向链接本技能。
[discrepancy] 身份/安装链接一致性 — SKILL.md 安装与 GitHub 链接指向 agentspace-so/runcomfy-skills，被 pin 镜像为 prime-skills/runcomfy-agent-skills——来源标识不一致（发布身份漂移）。
[unlocatable] SKILL.md 对 CLI 行为的断言（token 0600、2 GiB 上限、无 shell 展开） — CLI 源码不在本仓库，仅文档自述。

6结论

把『分辨率定价分层 + 草稿→定稿』的成本策略文档化，避免 agent 默认烧 4K

图内文字渲染的可操作语法（逐字引用 + 位置/字体声明）直击该模型主打能力

端点契约最明确：全仓库唯一给出完整 Model API URL 的文档，调用链清晰

safety 拨盘、批量数、宽高比、seed 等产品参数全暴露成字段表，agent 可精确控制

边界前置：422 反例与『编辑需求去 nano-banana-edit』导流，降低试错成本

适合：适合有 RunComfy 账号、需要快速出营销缩略图/社媒贴图/带图内文字的卡片海报的 agent 用户，尤其看重『多档分辨率控成本 + 批量 ideation + 图内排版文字』的场景；也适合做 Google Gemini 系生图模型的 prompt 写法参考。

不适合：不适合需要编辑已有图片（保主体换背景）的任务——那是 nano-banana-edit 的职责（文档自认）；不适合追求 2K/4K 高细节写实大片（应走 Seedream 5 / Nano Banana Pro）；不适合无 RunComfy 账号或拒绝素材/提示词上云的用户；也不适合需要稳定跨版本复现的用户（模型托管版本不在本仓库控制内）。

安装 agent 直装可复制

① 本站镜像更新 2026-09-09

方式 A · 人下载镜像包下载 nano-banana-2.tar.gz

sha256: c63e38a07d32fae6…

方式 B · JSON 格式安装指南，复制给 agent

安装指南

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② 上游 GitHub · 原始来源

能访问 GitHub？直接去上游安装（实时版，可能已更新）GitHub 原始 ↗

本页镜像锁定 commit fca19ae084；上游为实时仓库。

来源信息 GitHub 原始

作者 / 仓库prime-skills / prime-skills/runcomfy-agent-skills

原始 GitHubprime-skills/runcomfy-agent-skills ↗

Stars43

最近推送2026-05-15

本 skill commitfca19ae084

本站信息

收录日期2026-09-06

分类内容创作

侦查报告AI 侦查 · 2 遍 · 2026-09-06

本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。

nano-banana-2

1实现原理 · 为什么它能做到

2核心能力

3外部依赖

4风险提醒 风险提醒：橙色 · 评估后使用

5第二遍独立确认

6结论

4风险提醒风险提醒：橙色 · 评估后使用