コンテンツ制作 · prime-skills/runcomfy-agent-skills

nano-banana-2

RunComfy上でGoogle Nano Banana 2(Geminiファミリーのflashティアtext-to-image)を使用して画像を生成します。モデル公式のプロンプトパターンが同梱されているため、単純なプロンプト入力よりも精度の高い出力を得られます。Nano Banana 2の強み(迅速なイテレーション、画像内タイポグラフィ描画、予測可能な構図、オプションのWebグラウンディングによる文脈付与)、解像度別の価格設定、安全性の許容度ダイヤル、およびNano Banana Pro / GPT Image 2 / Flux 2 / Seedreamへルーティングすべき状況を解説しています。ローカルのRunComfy CLIを介して`runcomfy run google/nano-banana-2/text-to-image`を呼び出します。「nano banana」、「nano-banana-2」、「nano banana 2」、「google image gen」、「gemini image」、または本モデルを使用した生成の明示的な要求によってトリガーされます。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ネットワーク通信ファイル書き込みDual-pass Audit
Author prime-skillsGitHub prime-skills/runcomfy-agent-skills ↗Stars 43License MIT(仓库根 LICENSE:Copyright (c) 2026 RunComfy / agentspace-so;GitHub API spdx=MIT)Commit fca19ae084
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

単一モデル特化型(ルーター非該当):ドキュメント全体が単一のエンドポイント`google/nano-banana-2/text-to-image`を中心に構成され、「フィールドレベルのスキーマ + 解像度階層 + プロンプト構文」によって当該モデルの利用方法を網羅的に解説しています。

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枚のバッチアイディエーション)、4段階のresolution(0.5K/1K/2K/4Kの価格階層)、再現用seed、11種のアスペクト比(aspect_ratio)、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」がエージェントに直接公開されており、用途に応じてコンテンツフィルタリングの強度を調整できます。同テーブルの`resolution`には0.5K(ドラフト)/ 2K(最終)/ 4K(最大)と記載されており、説明欄の「resolution-tier pricing」で言及されているコスト削減戦略に対応しています。

プロンプトの提供価値 = 画像内タイポグラフィと構図の予測可能性:本文ではsubject-first構文 + 文字列の逐語引用記法を提示し、「制御が困難な文字描画」を実行可能なプロンプト規律へと昇華させています。

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.
これこそが「モデルの素の呼び出し」に対する本スキルの主要な付加価値です。subject-first宣言型構文(`Front-load subject; trail with directives`)+ 引用符によるテキストの逐語指定 + seed固定による反復 + スタイルの競合回避(1〜2個のアンカー)を徹底しています。

Webグラウンディングをデフォルトではなくオプションのトグルとして提供:enable_web_search=falseがデフォルトで無効化されており、プロンプトで時事問題や特定エンティティに言及する場合のみ有効化するよう制限し、そのトレードオフ(レイテンシ + コスト)も明記しています。

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.
この規律はプライバシーおよびコストに関する注意喚起でもあります。有効化すると、プロンプトがモデルのサーバー側でWeb検索に利用されます。

境界条件の明示:4段階の解像度および11種のアスペクト比以外の値を指定すると422エラーが発生します。また、画像編集の要求は兄弟関係にある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が固定のModel API URLへPOSTリクエストを送信、ポーリングを行って生成物をダウンロードします。

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は、調査対象の5ファイルの中で唯一「How-it-works」に完全なAPI URLを記載しており(他はドメインレベルの記述)、エンドポイントの規約が最も明確です。

2コア機能

01flashティアの高速t2i:0.5Kドラフトから2K完成形への段階的画像生成戦略
02単一リクエストでの4枚バッチアイディエーション(num_images=4 + 縦長アスペクト比)
03画像内タイポグラフィの予測可能な描画(逐語引用 + 位置/フォント制約構文)
04Webグラウンディングによる時事・エンティティ画像生成(enable_web_searchトグル)
05seed固定による再現可能なバリエーション比較
06安全性の許容度ダイヤルと単一ターンの生成数制限(safety_tolerance / limit_generations)
07ファミリー間のモデル選定ルーティング:Nano Banana Edit / Pro / GPT Image 2 / Flux 2 / Seedream 5との境界定義

3外部依存関係

KindDependency / Endpoint
cliruncomfy(@runcomfy/cli 官方 CLI)
package@runcomfy/cli(npm 全局安装)
apiGoogle Nano Banana 2 文生图端点(RunComfy Model API 托管)
network生成结果下载白名单
networkenable_web_search 联网检索(模型服务端执行)
networkRunComfy 模型页 / 文档站(引用链接)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • 网络端点: 外部ネットワークアクセスの宣言: model-api.runcomfy.net/v1/models/google/nano-banana-2/text-to-image — text-to-imageリクエスト
  • 本地工作目录: ファイル読み書きと成果物出力: CLIが生成された画像を--output-dirで指定されたローカルディレクトリ(パスは呼び出し側が決定)にダウンロード
  • SKILL.md: ホストCLIインタープリタまたは外部ランタイム環境の呼び出しを宣言
監査ノート: 今回の統一判定基準に基づく評価:ランタイムはサードパーティ製npmパッケージ/CLIである@runcomfy/cliを駆動し、このCLIは呼び出しごとにユーザーのRunComfy認証情報(~/.config/runcomfy/token.jsonまたはRUNCOMFY_TOKEN環境変数)を読み取ります。これは「サードパーティのnpm/CLIを呼び出し、クォータ/認証情報を読み取る可能性がある → オレンジ」に該当します。実行面(CLI、Model API、トークン読み取り)はすべてリポジトリ外部にあり、ドキュメントに記載された防御策(0600権限、2GiB上限、シェル展開なし)はこのピン留め環境内では検証できないため、「確証が持てない場合は上位ランクを適用する」方針に従いオレンジ判定とします。また外部ネットワーク送信も存在します:プロンプト(ブランドや未公開アセットの記述を含む可能性あり)がmodel-api.runcomfy.netを経由してサードパーティクラウドに送信されて生成が行われます。enable_web_search=trueの場合、プロンプトはモデルサーバー側のWeb検索にも利用されます(検索バックエンドおよびデータ保持ポリシーは未記載)。スキル自体は純粋な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結論

  • 「解像度別の価格設定 + ドラフトから完成形へ」のコスト戦略を文書化し、エージェントがデフォルトで4Kを浪費することを防止
  • 画像内テキスト描画の実用的な構文(逐語引用 + 位置/フォント宣言)がモデルの主要な強みに直結
  • エンドポイント規約の明確性:リポジトリ内で唯一完全なModel API URLを提示しており、呼び出し経路が明確
  • 安全性ダイヤル、バッチ数、アスペクト比、seedなどの製品パラメータがフィールド表として完全に公開され、エージェントによる精密な制御が可能
  • 境界条件の事前提示:422エラーのアンチパターンや「編集ニーズはnano-banana-editへ」という誘導により、試行錯誤のコストを削減
  • 最適な用途: RunComfyアカウントを所持し、マーケティング用サムネイル、SNS画像、文字入りカードポスターなどを迅速に生成したいエージェントユーザーに最適です。特に「段階的解像度によるコスト管理 + バッチアイディエーション + 画像内タイポグラフィ」を重視するシナリオや、Google Gemini系画像生成モデルのプロンプト作成リファレンスとして適しています。
    不向きな用途: 既存画像の編集(被写体を維持した背景変更など)を必要とするタスクには適していません(ドキュメント内でも明記されている通り、nano-banana-editの役割です)。2K/4Kの高精細でリアルな傑作画像を求める用途には不向きです(Seedream 5 / Nano Banana Proを使用すべきです)。RunComfyアカウントを持たないユーザーや、アセット/プロンプトのクラウド送信を許容できない環境、およびバージョン間での厳密な再現性を必要とするユースケース(ホストされるモデルのバージョン管理は本リポジトリの管轄外)には適していません。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload nano-banana-2.tar.gz
    sha256: c63e38a07d32fae6…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit fca19ae084.