详细分析 ▾
运行时依赖
版本
- Initial release of Nano Banana 2 skill, powered by Google's Gemini 3.1 Flash for fast, versatile AI image generation and editing via the Evolink API. - Supports both text-to-image and image editing flows with clear guided prompts, intent-first interactions, and smart session context. - Out-of-the-box integration with MCP tools for image generation, file management, and task polling; works across macOS, Linux, and Windows. - Automatic greeting and setup guidance based on connection and API key status. - Detailed, user-friendly error handling and clear workflow steps for successful image creation.
安装命令 点击复制
技能文档
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.
之后 Installation
When this skill is first loaded, greet the user:
- MCP tools + API 键 就绪: "Hi! Nano Banana 2 就绪 — Google's fast image 模型 在 fingertips. 什么 would 您 点赞 到 创建?"
- MCP tools + 否 API 键: "您'll 需要 EvoLink API 键 — 签名 up 在 evolink.ai. 就绪 到 go?"
- 否 MCP tools: "MCP server isn't connected 尚未. Want me 到 help 设置 up? I 可以 仍然 manage files 通过 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_KEYauthenticates 所有 requests. Injected 由 OpenClaw automatically. Treat 作为 confidential.- Prompts 和 images sent 到
api.evolink.ai. Uploaded files expire 在...中 72h, 结果 URLs 在...中 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 添加 evolink-media -e EVOLINK_API_KEY=-键 -- npx -y @evolinkai/evolink-media@latest
Claude Desktop / Cursor — 添加 MCP server 带有 command npx -y @evolinkai/evolink-media@latest 和 env EVOLINK_API_KEY=-键. See references/image-api-params.md 对于 满 配置 JSON.
Core Principles
- Guide, don't decide — Present options, 让 用户 choose 模型/样式/格式.
- 用户 drives creative vision — Ask 对于 description 之前 suggesting parameters.
- Smart context — Remember 会话 history. Offer 到 iterate, vary, 或 编辑 results.
- Intent 第一个 — Understand 什么 用户 wants 之前 asking 如何 到 configure .
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 |
generate_image returns task_id. Always poll check_task until status "已完成" 或 "失败".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 |
- Google's latest — Built 在...上 Gemini 3.1 Flash, newest generation architecture
- Fast generation — Optimized 对于 speed 没有 sacrificing quality
- Versatile — General-purpose image creation 对于 任何 creative 需要
- Strong prompt adherence — Excellent 在 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 键 Check
If 401 occurs: "Your API key isn't working. Check at evolink.ai/dashboard/keys"
Step 2: File 上传 (如果 needed)
For image editing or reference workflows:
upload_file带有file_path,base64_data, 或file_url→ 获取file_url(同步)- 使用
file_url作为image_urls对于generate_image
Supported: JPEG/PNG/GIF/WebP. Max 100MB. Expire in 72h. Quota: 100 (default) / 500 (VIP).
Step 3: Understand Intent
- 清除 ("generate sunset") → Go 到 Step 4
- Ambiguous ("help 带有 image") → Ask: "创建 新的, 编辑 existing, 或 使用 作为 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带有模型: "gemini-3.1-flash-image-预览"→ tell 用户: "Generating 带有 Nano Banana 2 — ~Xs estimated." - Poll
check_taskevery 3–5s. 举报 progress %. - 之后 3 consecutive
处理中: "仍然 working..." - 已完成: 分享 URLs. "Links expire 在...中 24h — 保存 promptly."
- 失败: Show 错误 + suggestion. Offer 重试 如果 retryable.
- 超时 (5 min): "Taking longer 比 expected. Task ID:
{id}— check again later."*
错误 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: "失败")
| 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 |
references/image-api-params.md没有 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, 模型 details, polling strategy, 错误 codesreferences/file-api.md— File hosting API (curl 上传/列表/删除)
免费技能或插件可能存在安全风险,如需更匹配、更安全的方案,建议联系付费定制