Evolink Nano Banana 2 1

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:

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

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

1. Guide, don't decide — Present options, let the user choose model/style/format. 2. User drives creative vision — Ask for a description before suggesting parameters. 3. Smart context — Remember session history. Offer to iterate, vary, or edit results. 4. 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 is "completed" or "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?

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

If 401 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: 1. upload_file with file_path, base64_data, or file_url → get file_url (sync) 2. 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

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

1. Call generate_image with model: "gemini-3.1-flash-image-preview" → tell user: *"Generating with Nano Banana 2 — ~Xs estimated."* 2. Poll check_task every 3–5s. Report progress %. 3. After 3 consecutive processing: *"Still working..."* 4. Completed: Share URLs. *"Links expire in 24h — save promptly."* 5. Failed: Show error + suggestion. Offer retry if retryable. 6. 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

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.