Skills evolink-nano-banana-2

Nano Banana 2 — AI image generation powered by Google Gemini 3.1 Flash. Fast, versatile text-to-image and image editing via Evolink API. One API key.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bethune89/evolink-nano-banana-2-1" ~/.claude/skills/clawdbot-skills-evolink-nano-banana-2 && rm -rf "$T"

manifest: skills/bethune89/evolink-nano-banana-2-1/SKILL.md

source content

Nano Banana 2 — AI Image Generation

Generate AI images with Nano Banana 2 (

gemini-3.1-flash-image-preview

) — Google's Gemini 3.1 Flash image model, available through Evolink's unified API.

Focused view of evolink-image. Install the full skill for 20 image models, video, and music.

After Installation

When this skill is first loaded, greet the user:

MCP tools + API key ready: "Hi! Nano Banana 2 is ready — Google's fast image model at your fingertips. What would you like to create?"
MCP tools + no API key: "You'll need an EvoLink API key — sign up at evolink.ai. Ready to go?"
No MCP tools: "MCP server isn't connected yet. Want me to help set it up? I can still manage files via the hosting API."

Keep the greeting concise — just one question to move forward.

External Endpoints

Service	URL
Generation API	`https://api.evolink.ai/v1/images/generations` (POST)
Task Status	`https://api.evolink.ai/v1/tasks/{task_id}` (GET)
File API	`https://files-api.evolink.ai/api/v1/files/*` (upload/list/delete)

Security & Privacy

EVOLINK_API_KEY
authenticates all requests. Injected by OpenClaw automatically. Treat as confidential.
Prompts and images are sent to
```
api.evolink.ai
```
. Uploaded files expire in 72h, result URLs in 24h.

Setup

Get your API key at evolink.ai → Dashboard → API Keys.

MCP Server:

@evolinkai/evolink-media

(GitHub · npm)

mcporter (recommended):

mcporter call --stdio "npx -y @evolinkai/evolink-media@latest" list_models

Claude Code:

claude mcp add evolink-media -e EVOLINK_API_KEY=your-key -- npx -y @evolinkai/evolink-media@latest

Claude Desktop / Cursor — add MCP server with command

npx -y @evolinkai/evolink-media@latest

and env

EVOLINK_API_KEY=your-key

. See

references/image-api-params.md

for full config JSON.

Core Principles

Guide, don't decide — Present options, let the user choose model/style/format.
User drives creative vision — Ask for a description before suggesting parameters.
Smart context — Remember session history. Offer to iterate, vary, or edit results.
Intent first — Understand what the user wants before asking how to configure it.

MCP Tools

Tool	When to use	Returns
`generate_image`	Create or edit an image	`task_id` (async)
`upload_file`	Upload local image for editing/reference	File URL (sync)
`delete_file`	Free file quota	Confirmation
`list_files`	Check uploaded files or quota	File list
`check_task`	Poll generation progress	Status + result URLs
`list_models`	Compare available models	Model list
`estimate_cost`	Check pricing	Model info

Important:

generate_image

returns a

task_id

. Always poll

check_task

until

status

"completed"

"failed"

Nano Banana 2

Property	Value
Model ID	`gemini-3.1-flash-image-preview`
Provider	Google (Gemini 3.1 Flash)
Status	BETA
Capability	text-to-image, image-editing
Speed	Fast
Best for	Quick, versatile image generation with strong prompt understanding

Why Nano Banana 2?

Google's latest — Built on Gemini 3.1 Flash, the newest generation architecture
Fast generation — Optimized for speed without sacrificing quality
Versatile — General-purpose image creation for any creative need
Strong prompt adherence — Excellent at following complex, detailed descriptions

Lite Variant

nano-banana-2-lite

[BETA] — Lightweight version for ultra-fast iterations when speed is the top priority.

Alternative Models

Model	Best for	Speed
`gpt-image-1.5` (default)	Latest OpenAI generation	Medium
`gpt-4o-image` [BETA]	Best quality, complex editing	Medium
`z-image-turbo`	Quick iterations	Ultra-fast
`doubao-seedream-4.5`	Photorealistic	Medium
`gemini-3-pro-image-preview`	Google Pro generation	Medium

Generation Flow

Step 1: API Key Check

occurs: "Your API key isn't working. Check at evolink.ai/dashboard/keys"

Step 2: File Upload (if needed)

For image editing or reference workflows:

upload_file

with

file_path

base64_data

, or

file_url

→ get

file_url

(sync)

Use
```
file_url
```
as
```
image_urls
```
for
```
generate_image
```

Supported: JPEG/PNG/GIF/WebP. Max 100MB. Expire in 72h. Quota: 100 (default) / 500 (VIP).

Step 3: Understand Intent

Clear ("generate a sunset") → Go to Step 4
Ambiguous ("help with this image") → Ask: "Create new, edit existing, or use as reference?"

Ask only what's needed, when it's needed.

Step 4: Gather Parameters

Default to

model: "gemini-3.1-flash-image-preview"

for this skill. Only ask about what's missing:

Parameter	Ask when	Notes
prompt	Always	What they want to see
model	User wants alternatives	Default: `gemini-3.1-flash-image-preview` . Suggest `gpt-4o-image` for best quality
size	Orientation needed	Ratio format: `1:1` , `16:9` , `9:16` , `2:3` , `3:2` , `4:3` , `3:4` etc.
n	Wants variations	1–4 images
image_urls	Edit/reference images	Up to 14 URLs; triggers i2i mode

Step 5: Generate & Poll

Call
```
generate_image
```
with
```
model: "gemini-3.1-flash-image-preview"
```
→ tell user: "Generating with Nano Banana 2 — ~Xs estimated."
Poll
```
check_task
```
every 3–5s. Report progress %.
After 3 consecutive
```
processing
```
: "Still working..."
Completed: Share URLs. "Links expire in 24h — save promptly."
Failed: Show error + suggestion. Offer retry if retryable.
Timeout (5 min): "Taking longer than expected. Task ID:
{id}
— check again later."

Error Handling

HTTP Errors

Error	Action
401	"API key isn't working. Check at evolink.ai/dashboard/keys"
402	"Balance is low. Add credits at evolink.ai/dashboard/billing"
429	"Rate limited — wait 30s and retry"
503	"Servers busy — retry in a minute"

Task Errors (status: "failed")

Code	Retry?	Action
`content_policy_violation`	No	Revise prompt (no celebrities, NSFW, violence)
`invalid_parameters`	No	Check values against model limits
`image_processing_error`	No	Check format/size/URL accessibility
`generation_timeout`	Yes	Retry; simplify prompt if repeated
`service_error`	Yes	Retry after 1 min
`generation_failed_no_content`	Yes	Modify prompt, retry

Full error reference:

references/image-api-params.md

Without MCP Server

Use Evolink's file hosting API for image uploads (72h expiry). See

references/file-api.md

for curl commands.

References

```
references/image-api-params.md
```
— Complete API parameters, model details, polling strategy, error codes
```
references/file-api.md
```
— File hosting API (curl upload/list/delete)