Skill: kalvinrv/nano-banana-2-runcomfy (version 0.1.2)

--- name: nano-banana-2-runcomfy displayName: "🫧 Nano Banana 2 — Pro Pack on RunComfy" description: > Nano Banana 2 on RunComfy. Nano Banana 2 is Google's flash-tier text-to-image model in the Gemini family — fast iteration, predictable framing, in-image typography rendering, optional web-grounded context. This skill calls Nano Banana 2 through the RunComfy CLI: `runcomfy run google/nano-banana-2/text-to-image`. Nano Banana 2 is the right Nano Banana variant for marketing drafts, social thumbnails, and batch variants. Triggers on "nano banana", "nano-banana", "nano banana 2", "nano-banana-2", "Google Nano Banana", "Gemini image", or any explicit ask to generate with Nano Banana. emoji: "🫧" homepage: https://www.runcomfy.com license: MIT clawdis: requires: bins: - runcomfy env: - RUNCOMFY_TOKEN config: - ~/.config/runcomfy --- # 🫧 Nano Banana 2 — Pro Pack on RunComfy [runcomfy.com](https://www.runcomfy.com/?utm_source=clawhub&utm_medium=skill&utm_campaign=nano-banana-2-runcomfy) · [docs](https://docs.runcomfy.com/cli/introduction?utm_source=clawhub&utm_medium=skill&utm_campaign=nano-banana-2-runcomfy) · [Nano Banana 2 model page](https://www.runcomfy.com/models/google/nano-banana-2?utm_source=clawhub&utm_medium=skill&utm_campaign=nano-banana-2-runcomfy) **Nano Banana 2** is the flash-tier text-to-image model in Google's Gemini family. This skill generates images with Nano Banana 2 hosted on the RunComfy Model API — `runcomfy run google/nano-banana-2/text-to-image` from your terminal, no Google API key, no GPU rental. ## What Nano Banana 2 is Nano Banana 2 is Google's second-generation flash-tier image model — the iteration-speed-first variant in the Nano Banana line. Three properties make Nano Banana 2 distinct: - **Rapid Nano Banana iteration.** Nano Banana 2 is the fastest path to a draft in the Nano Banana family. A Nano Banana 2 generation lands in seconds rather than tens of seconds, which makes Nano Banana 2 the right Nano Banana for marketing brainstorming, A/B variants, and batch ideation. - **Predictable Nano Banana framing.** Nano Banana 2 holds composition stable across small prompt edits — change one descriptor, Nano Banana keeps the rest. This makes Nano Banana 2 ideal for refining a single hero image without redrafting it from scratch. - **In-image typography on Nano Banana 2.** Nano Banana 2 renders quoted text inside the image with strong fidelity for short headlines, brand marks, and poster-style copy. When you put `"AURA"` in the Nano Banana 2 prompt, the literal word appears in the image — Nano Banana doesn't paraphrase or scramble. Nano Banana 2 also exposes an optional **web-grounded context** flag (`enable_web_search`) for image generation that references current events or real entities. The Nano Banana web grounding adds latency and cost; off by default. ## When Nano Banana 2 is the right choice Pick Nano Banana 2 when any of these is true: - You want **rapid Nano Banana drafts** — social thumbnails, batch variants, ideation rounds. Nano Banana 2 is built for this speed. - You're producing **in-image typography** — quoted headlines, brand marks, poster copy. Nano Banana 2 renders text predictably. - You're iterating **one Nano Banana hero image** through small prompt edits — Nano Banana 2 keeps composition stable across rounds. - You need **web-grounded Nano Banana imagery** referencing current events or real-world entities — Nano Banana 2 supports this via `enable_web_search`. - The user explicitly asked for **Nano Banana 2** / **nano-banana-2** / **Google Nano Banana** — route to this Nano Banana variant regardless. ## Nano Banana 2 vs Nano Banana Pro The Nano Banana family has two production tiers. Pick the right Nano Banana variant based on intent: - **Nano Banana 2** (this skill) — flash tier. Fast Nano Banana iteration, marketing drafts, social thumbnails, batch ideation, in-image typography. - **Nano Banana Pro** (separate skill) — pro tier. Hyperrealistic Nano Banana portraits, maximum Nano Banana detail, slower per-call but higher fidelity. If the user said just "Nano Banana" without specifying 2 vs Pro, default to Nano Banana 2 for ideation, batches, and typography work; default to Nano Banana Pro for portrait fidelity. ## Prerequisites 1. **RunComfy CLI** — `npm i -g @runcomfy/cli` 2. **RunComfy account** — `runcomfy login` opens a browser device-code flow. 3. **CI / containers** — set `RUNCOMFY_TOKEN=<token>` instead of `runcomfy login`. ## Endpoint + input schema ### [REDACTED_SECRET] This is the Nano Banana 2 text-to-image endpoint. The Nano Banana 2 edit endpoint runs on a separate template not covered here. | Field | Type | Required | Default | Notes | |---|---|---|---|---| | `prompt` | string | yes | — | Subject-first description for Nano Banana 2. | | `num_images` | int | no | 1 | 1–4. Use 4 for Nano Banana ideation rounds. | | `seed` | int | no | 0 | Reuse for reproducible Nano Banana 2 output. | | `aspect_ratio` | enum | no | `auto` | 11 values: `auto`, `21:9`, `16:9`, `3:2`, `4:3`, `5:4`, `1:1`, `4:5`, `3:4`, `2:3`, `9:16`. | | `resolution` | enum | no | `1K` | `0.5K` (Nano Banana drafts), `1K` (default), `2K` (final), `4K` (max). | | `output_format` | enum | no | `png` | `png`, `jpeg`, `webp`. | | `safety_tolerance` | int | no | 4 | 1 (strict) – 6 (permissive). | | `limit_generations` | bool | no | true | Limit each Nano Banana prompt round to one generation. | | `enable_web_search` | bool | no | false | Adds Nano Banana web grounding (extra cost + latency). | For Nano Banana 2 image edit (preserve subject + apply changes), see the sibling [`nano-banana-edit`](../nano-banana-edit) skill. ## How to invoke Nano Banana 2 **Default Nano Banana 2 draft (1K, square, png):** ```bash runcomfy run google/nano-banana-2/text-to-image \ --input '{"prompt": "<Nano Banana prompt>"}' \ --output-dir <absolute/path> ``` **Nano Banana 2 vertical 4-up batch for ideation:** ```bash runcomfy run google/nano-banana-2/text-to-image \ --input '{ "prompt": "<Nano Banana prompt>", "num_images": 4, "aspect_ratio": "9:16", "resolution": "0.5K" }' \ --output-dir <absolute/path> ``` **Final Nano Banana 2 at 2K with seed lock:** ```bash runcomfy run google/nano-banana-2/text-to-image \ --input '{ "prompt": "<Nano Banana prompt>", "resolution": "2K", "aspect_ratio": "16:9", "seed": 42 }' \ --output-dir <absolute/path> ``` **Web-grounded Nano Banana 2 (current event / real entity):** ```bash runcomfy run google/nano-banana-2/text-to-image \ --input '{ "prompt": "<Nano Banana prompt referencing a real-world event from this week>", "enable_web_search": true }' \ --output-dir <absolute/path> ``` ## Prompting Nano Banana 2 — what works Nano Banana 2 responds to specific prompting patterns better than naive prose. Apply these for sharper Nano Banana output. **Subject-first declarative grammar.** "A cinematic close-up portrait of an American woman standing under neon lights in rainy Tokyo, shallow depth of field, reflective wet streets, ultra-detailed, realistic skin texture" — primary subject first, then action, environment, style, camera. Nano Banana 2 reads early tokens with more weight; front-load the subject. **Exact text quoting for in-image typography.** "The label reads 'AURA' in clean bold sans-serif, centered, white on black" — quote the literal characters Nano Banana should render. Specify placement and font style. Don't say "with the brand name on it" and hope Nano Banana figures it out. **Consistent seeds for Nano Banana refinement.** Lock `seed` when iterating a single Nano Banana prompt across small variants — keeps Nano Banana composition stable so you can compare apples to apples. **Web-grounding sparingly.** Turn on `enable_web_search` only when the Nano Banana prompt names current events or real entities. Adds latency + cost; off by default. **Don't conflict styles for Nano Banana.** "minimalist + ornate + retro + cyberpunk" cancels in Nano Banana output. Pick 1–2 anchors. **Nano Banana 2 anti-patterns:** - Trying to verbally describe a stable subject identity in Nano Banana → use the Nano Banana edit endpoint with image refs instead. - Asking Nano Banana for resolutions outside the 4 tiers → 422. - Aspect ratios outside the 11 supported Nano Banana values → 422. - Non-quoted in-image text → unpredictable Nano Banana rendering. ## Where Nano Banana 2 shines | Use case | Why Nano Banana 2 | |---|---| | **Marketing draft thumbnails (batch of 4)** | Nano Banana 2 fast iteration at 0.5K, then promote winner to 2K | | **Social-platform-native** | Nano Banana 2 wide aspect ratio support including 9:16, 4:5, 21:9 | | **In-image typography for posters / cards** | Nano Banana 2 predictable text rendering when characters are quoted | | **Web-grounded current-event imagery** | Nano Banana 2 `enable_web_search` integrates fresh info | | **Reproducible Nano Banana variant testing** | Strong Nano Banana seed + consistent framing | ## Sample Nano Banana 2 prompts (verified to produce strong results) **Cinematic Nano Banana portrait (page example):** ``` A cinematic close-up portrait of an American woman standing under neon lights in rainy Tokyo, shallow depth of field, reflective wet streets, ultra-detailed, realistic skin texture ``` **Brand-asset card with quoted text (Nano Banana typography):** ``` A minimalist 16:9 product card: a matte black ceramic mug centered on a soft warm-grey paper background, rim highlight from upper-left, the headline "Brewed Quietly" in clean bold sans-serif top-right, balanced negative space below, e-commerce ready, clean studio lighting ``` **Vertical Nano Banana platform-native:** ``` A 9:16 vertical hero for a wellness brand: a single ceramic teacup on a linen runner, soft morning side-light, the words "Slow Down" in hand-drawn serif large at the top, gentle steam rising, neutral color palette, uncluttered ``` ## Nano Banana 2 FAQ **What's the difference between Nano Banana 2 and Nano Banana Pro?** Nano Banana 2 is the flash tier (fast, predictable, drafts and typography). Nano Banana Pro is the pro tier (slower, higher fidelity, portraits). This skill is the Nano Banana 2 variant. **What resolutions does Nano Banana 2 support?** Four: `0.5K` (drafts), `1K` (default), `2K` (final), `4K` (max). 2K and 4K Nano Banana cost more. **Can Nano Banana 2 generate multiple images per call?** Yes — set `num_images: 4`. Useful for Nano Banana ideation batches. **Does Nano Banana 2 do image edit?** Not on this endpoint. For Nano Banana edit (preserve subject + apply changes), use the [nano-banana-edit](../nano-banana-edit) skill. **Why is `enable_web_search` off by default?** Nano Banana web grounding adds latency and cost. Only enable when the prompt explicitly references current events. **What languages does Nano Banana 2 understand in the prompt?** English is the most reliable for Nano Banana. Multilingual prompts work for layout/style but in-image text is best in Latin-script languages. **How do I reproduce a Nano Banana 2 output?** Pass `seed` as a fixed int. Same prompt + same seed = same Nano Banana generation. ## Limitations of Nano Banana 2 - **Nano Banana 2 is still images only.** No video on this Nano Banana endpoint. - **Max 4 outputs per Nano Banana request.** - **Nano Banana web search adds latency + cost** — only enable on demand. - **Nano Banana 2K / 4K cost more** — default to 1K unless user asked for higher. - **For Nano Banana image edit, use the dedicated edit skill** — not this endpoint. ## Exit codes | code | meaning | |---|---| | 0 | Nano Banana generation succeeded | | 64 | bad CLI args | | 65 | bad input JSON for Nano Banana / schema mismatch | | 69 | upstream 5xx | | 75 | retryable: timeout / 429 | | 77 | not signed in or token rejected | Full reference: [docs.runcomfy.com/cli/troubleshooting](https://docs.runcomfy.com/cli/troubleshooting?utm_source=clawhub&utm_medium=skill&utm_campaign=nano-banana-2-runcomfy). ## How it works The skill invokes `runcomfy run google/nano-banana-2/text-to-image` with a JSON body matching the Nano Banana 2 schema. The CLI POSTs to `https://model-api.runcomfy.net/v1/models/google/nano-banana-2/text-to-image`, polls the Nano Banana request, fetches the Nano Banana result, and downloads any `.runcomfy.net` / `.runcomfy.com` URL into `--output-dir`. `Ctrl-C` cancels the remote Nano Banana request before exit. ## Security & Privacy - **Token storage**: `runcomfy login` writes the API token to `~/.config/runcomfy/token.json` with mode 0600. - **Input boundary**: the Nano Banana prompt is passed as JSON via `--input`. No shell injection. - **Third-party content**: image URLs are fetched by the RunComfy server. Treat external URLs as untrusted — image-based prompt injection is a known risk. - **Outbound endpoints**: only `model-api.runcomfy.net` and `*.runcomfy.net` / `*.runcomfy.com`. - **Generated-file size cap**: 2 GiB.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)