Evolink Image: 多模型 AI 图像生成 - Openclaw Skills

作者:互联网

2026-03-30

AI教程

什么是 Evolink Image?

Evolink Image 是一款多功能工具,专为需要访问多种 AI 图像生成模型而无需管理多个 API 密钥的开发人员和创作者而设计。通过与 Openclaw Skills 集成,该工具提供了通往 20 种不同模型的统一门户,包括 GPT-4o Image、Gemini 和 Seedream,实现了高质量的文生图和图生图工作流。

无论您是执行复杂的局部重绘,还是使用超快速模型进行快速原型设计,此技能都能简化创作过程。它处理异步任务管理和文件托管的复杂性,使其成为 Openclaw Skills 生态系统中任何开发人员工具包的重要补充。

下载入口:https://github.com/openclaw/skills/tree/main/skills/evolinkai/evolink-image

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install evolink-image

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 evolink-image。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Evolink Image 应用场景

  • 为营销材料创建高保真写实图像。
  • 使用 turbo 模型快速迭代 UI/UX 模型。
  • 使用 GPT-4o 进行高级图像编辑和重绘。
  • 使用图生图模型将现有图像转换为新风格。
  • 通过集成的文件 API 管理 AI 生成资产的集中库。
Evolink Image 工作原理
  1. 用户提供文本提示或使用集成上传工具上传初始图像。
  2. 技能验证 Evolink API 密钥和用户意图,以选择最合适的模型。
  3. 通过 generate_image 工具启动生成任务,并返回唯一的任务 ID。
  4. 系统每隔几秒自动轮询任务状态,提供实时进度更新。
  5. 完成后,技能会获取最终的图像 URL 并呈现给用户进行下载。

Evolink Image 配置指南

首先,从 Evolink 控制面板获取 API 密钥。要将其作为 Openclaw Skills 配置的一部分添加到您的环境中,请使用以下命令:

# 对于 Claude Code
claude mcp add evolink-media -e EVOLINK_API_KEY=your-key -- npx -y @evolinkai/evolink-media@latest

对于桌面或 Cursor 用户,使用 npx -y @evolinkai/evolink-media@latest 配置 MCP 服务器,并确保设置了 EVOLINK_API_KEY 环境变量。

Evolink Image 数据架构与分类体系

该技能通过结构化 API 和临时托管管理数据,以确保 Openclaw Skills 内部的效率。

功能 详情
文件有效期 上传的文件在 72 小时后过期。
结果有效期 生成的图像 URL 保持 24 小时有效。
支持的格式 JPEG, PNG, GIF, 和 WebP。
最大文件大小 每次上传高达 100MB。
文件配额 默认用户 100 个文件;VIP 500 个。
元数据 所有请求均通过主 EVOLINK_API_KEY 进行身份验证。
name: evolink-image
description: AI image generation & editing — GPT Image, GPT-4o, Nano Banana 2, Seedream, Qwen, WAN, Gemini. Text-to-image, image-to-image, inpainting. 20 models, one API key.
version: 1.4.0
user-invocable: true
metadata:
  openclaw:
    requires:
      env:
        - EVOLINK_API_KEY
    primaryEnv: EVOLINK_API_KEY
    os: ["macos", "linux", "windows"]
    emoji: ???
    homepage: https://evolink.ai

Generate and edit AI images with 20 models including GPT Image 1.5, GPT-4o Image, Nano Banana 2, 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 — 20 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

  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".

Image Models (20)

Top Picks

Model Best for Speed
gpt-image-1.5 (default) Latest OpenAI generation Medium
gemini-3.1-flash-image-preview Nano Banana 2 — Google's fast generation Fast
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 (16)

gpt-image-1.5, gpt-image-1, gemini-3.1-flash-image-preview, 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:

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

  1. Call generate_image → tell user: "Generating now — ~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_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)