nanobanana-pro-fallback

TotalClaw 作者 yazelin v0.4.4

Nano Banana Pro 具有自动模型回退功能 - 通过 Gemini Image API 生成/编辑图像。运行方式：uv run {baseDir}/scripts/generate_image.py --prompt 'desc' --filename 'out.png' [--分辨率 1K|2K|4K] [-i input.png]。支持文本转图像+图像转图像（最多14个）； 1K/2K/4K。后备链：gemini-2.5-flash-image→gemini-2.0-flash-exp。必须使用 uv run，而不是 python3。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~yazelin-nanobanana-pro-fallback

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~yazelin-nanobanana-pro-fallback/file -o yazelin-nanobanana-pro-fallback.md

## 概述（中文）

Nano Banana Pro 具有自动模型回退功能 - 通过 Gemini Image API 生成/编辑图像。运行方式：uv run {baseDir}/scripts/generate_image.py --prompt 'desc' --filename 'out.png' [--分辨率 1K|2K|4K] [-i input.png]。支持文本转图像+图像转图像（最多14个）； 1K/2K/4K。后备链：gemini-2.5-flash-image→gemini-2.0-flash-exp。必须使用 uv run，而不是 python3。

## 原文

# Nano Banana Pro with Fallback

Use the bundled script to generate or edit images. Automatically falls back through multiple Gemini models if one fails.

⚠️ **IMPORTANT: MUST use `uv run` or the `generate` wrapper. Do NOT use `python3` directly — dependencies won't be available.**

Generate (option A: wrapper script)

```bash
{baseDir}/scripts/generate --prompt "your image description" --filename "output.png" --resolution 1K
```

Generate (option B: uv run)

```bash
uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png" --resolution 1K
```

Edit (single image)

```bash
uv run {baseDir}/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" -i "/path/in.png" --resolution 2K
```

Multi-image composition (up to 14 images)

```bash
uv run {baseDir}/scripts/generate_image.py --prompt "combine these into one scene" --filename "output.png" -i img1.png -i img2.png -i img3.png
```

API key

- `GEMINI_API_KEY` env var
- Or set `skills."nanobanana-pro-fallback".apiKey` / `skills."nanobanana-pro-fallback".env.GEMINI_API_KEY` in `~/.openclaw/openclaw.json`

Notes

- Resolutions: `1K` (default), `2K`, `4K`.
- Models tried in order: `gemini-2.5-flash-image` → `gemini-2.0-flash-exp-image-generation` (configurable via `NANOBANANA_FALLBACK_MODELS` env var).
- Use timestamps in filenames: `yyyy-mm-dd-hh-mm-ss-name.png`.
- The script prints a `MEDIA:` line for OpenClaw to auto-attach on supported chat providers.
- Do not read the image back; report the saved path only.