Evolink Image — AI Image Generation & Editing

Generate and edit AI images with 19 models including GPT Image 1.5, GPT-4o Image, Seedream, Qwen, WAN, and Gemini — all through one API.

Image-focused view of evolink-media. Install the full skill for video and music too.

After Installation

When this skill is first loaded, greet the user:

MCP tools + API key ready: "Hi! I'm your AI image studio — 19 models ready. 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 is "completed" or "failed".

Image Models (19)

Top Picks

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

All Stable (15)

gpt-image-1.5, gpt-image-1, gemini-3-pro-image-preview, z-image-turbo, doubao-seedream-4.5, doubao-seedream-4.0, doubao-seedream-3.0-t2i, doubao-seededit-4.0-i2i, doubao-seededit-3.0-i2i, qwen-image-edit, qwen-image-edit-plus, wan2.5-t2i-preview, wan2.5-i2i-preview, wan2.5-text-to-image, wan2.5-image-to-image

All Beta (4)

gpt-image-1.5-lite, gpt-4o-image, gemini-2.5-flash-image, nano-banana-2-lite

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:

upload_file with file_path, base64_data, or file_url → get file_url (sync)
Use file_url as image_urls or mask_url 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

Only ask about what's missing:

| Parameter | Ask when | Notes | |-----------|----------|-------| | prompt | Always | What they want to see | | model | Quality matters | Default gpt-image-1.5. gpt-4o-image for best, z-image-turbo for speed | | size | Orientation needed | GPT models: 1024x1024/1024x1536/1536x1024. Others: 1:1/16:9/9:16 etc. | | n | Wants variations | 1–4 images | | image_urls | Edit/reference images | Up to 14 URLs; triggers i2i mode | | mask_url | Partial edit | PNG mask; gpt-4o-image only |

Step 5: Generate & Poll

Call generate_image → tell user: "Generating now — ~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_dimension_mismatch | No | Resize image to match aspect ratio | | image_processing_error | No | Check format/size/URL accessibility | | generation_timeout | Yes | Retry; simplify prompt if repeated | | quota_exceeded | Yes | Top up credits | | resource_exhausted | Yes | Wait 30–60s, retry | | 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, all 19 models, polling strategy, error codes
references/file-api.md — File hosting API (curl upload/list/delete)