1仕組みと動作原理
単一モデル特化型(ルーター非該当):ドキュメント全体が単一のエンドポイント`google/nano-banana-2/text-to-image`を中心に構成され、「フィールドレベルのスキーマ + 解像度階層 + プロンプト構文」によって当該モデルの利用方法を網羅的に解説しています。
### `google/nano-banana-2/text-to-image`
パラメータテーブルによる機能実現:num_images(1〜4枚のバッチアイディエーション)、4段階のresolution(0.5K/1K/2K/4Kの価格階層)、再現用seed、11種のアスペクト比(aspect_ratio)、safety_tolerance(1:厳格〜6:寛容)、enable_web_search、limit_generationsのすべてが「デフォルト値 + 列挙型 + 使用ヒント」として組み込まれています。
| `safety_tolerance` | int | no | 4 | 1 (strict) – 6 (permissive). |
プロンプトの提供価値 = 画像内タイポグラフィと構図の予測可能性:本文ではsubject-first構文 + 文字列の逐語引用記法を提示し、「制御が困難な文字描画」を実行可能なプロンプト規律へと昇華させています。
**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.
Webグラウンディングをデフォルトではなくオプションのトグルとして提供:enable_web_search=falseがデフォルトで無効化されており、プロンプトで時事問題や特定エンティティに言及する場合のみ有効化するよう制限し、そのトレードオフ(レイテンシ + コスト)も明記しています。
**Web-grounding, sparingly.** Turn on `enable_web_search` only when the prompt names current events / real entities. Adds latency + cost; off by default.
境界条件の明示:4段階の解像度および11種のアスペクト比以外の値を指定すると422エラーが発生します。また、画像編集の要求は兄弟関係にあるnano-banana-edit(/editエンドポイントの使用)へ明示的に誘導されます。
- Asking for resolutions outside the 4 tiers → 422.
実行をruncomfy CLIへ委任:`runcomfy run google/nano-banana-2/text-to-image --input '{...}' --output-dir`を実行し、CLIが固定のModel API URLへPOSTリクエストを送信、ポーリングを行って生成物をダウンロードします。
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`.
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| 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推奨統制措置と判定根拠
- 网络端点: 外部ネットワークアクセスの宣言: model-api.runcomfy.net/v1/models/google/nano-banana-2/text-to-image — text-to-imageリクエスト
- 本地工作目录: ファイル読み書きと成果物出力: CLIが生成された画像を--output-dirで指定されたローカルディレクトリ(パスは呼び出し側が決定)にダウンロード
- SKILL.md: ホストCLIインタープリタまたは外部ランタイム環境の呼び出しを宣言
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結論
c63e38a07d32fae6…