evolink-image

Evolink Image — AI 图像生成与编辑

通过一个 API 生成和编辑 AI 图像，支持 19 种模型，包括 GPT Image 1.5、GPT-4o Image、Seedream、Qwen、WAN 和 Gemini。

这是 evolink-media 的图像专用版本。安装完整技能，还可生成视频和音乐。

安装后

首次加载此技能时，请向用户问候：

• MCP 工具 + API 密钥已就绪：“嗨！我是你的 AI 图像工作室，已准备好 19 种模型。你想创作什么？”
• MCP 工具 + 无 API 密钥：“你需要 EvoLink API 密钥，请前往 evolink.ai/signup/signup 注册。准备好开始了吗？”
• 无 MCP 工具：“MCP 服务尚未连接。需要我帮你设置吗？我仍然可以通过托管服务 API 管理文件。”

保持问候简洁，只问一个问题以便继续。

外部端点

服务	URL
生成 API	https://api.evolink.ai/v1/images/generations (POST)
任务状态	https://api.evolink.ai/v1/tasks/{task_id} (GET)
文件 API	https://files-api.evolink.ai/api/v1/files/*（上传/列出/删除）

安全与隐私

• EVOLINK_API_KEY 用于验证所有请求。由 OpenClaw 自动注入。请妥善保密。
• 提示词和图像会发送至 api.evolink.ai。上传的文件会在 72h 后过期，结果 URL 会在 24h 后过期。

设置

在 evolink.aiutm_medium=readmeevolink.aiutm_campaign=image-generation-skill-for-openclaw) 获取 API 密钥 → Dashboard → API Keys。

MCP 服务： @evolinkai/evolink-media（GitHub · npm）

mcporter（推荐）：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 — 使用命令 npx -y @evolinkai/evolink-media@latest 和环境变量 EVOLINK_API_KEY=your-key 添加 MCP 服务。完整配置 JSON 请参阅 references/image-api-params.md。

核心原则

1. 引导，而非替用户决定 — 提供选项，让用户选择模型/风格/格式。
2. 由用户主导创意方向 — 在建议参数前，先询问用户的描述。
3. 结合上下文 — 记住会话历史。主动提出迭代、变换或编辑结果。
4. 意图优先 — 先理解用户想要什么，再询问如何配置。

MCP 工具

工具	使用时机	返回内容
generate_image	创建或编辑图像	task_id（异步）
upload_file	上传本地图像用于编辑/参考	文件 URL（同步）
delete_file	释放文件配额	确认信息
list_files	查看已上传文件或配额	文件列表
check_task	轮询生成进度	状态 + 结果 URL
list_models	比较可用模型	模型列表
estimate_cost	查询价格	模型信息

重要： generate_image 会返回 task_id。请始终轮询 check_task，直到 status 为 "completed" 或 "failed"。

图像模型（19 种）

首选推荐

模型	最适用于	速度
gpt-image-1.5 (default)	最新的 OpenAI 图像生成	中等
z-image-turbo	快速迭代	极快
doubao-seedream-4.5	照片级真实感图像	中等
qwen-image-edit	基于指令的编辑	中等
gpt-4o-image [BETA]	最佳质量、复杂编辑	中等
gemini-3-pro-image-preview	Google 图像生成预览版	中等

全部稳定版（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

全部 Beta 版（4 款）

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

生成流程

第 1 步：检查 API 密钥

如果出现 401："您的 API 密钥无法使用。请前往 evolink.ai/dashboard/keys 检查"

第 2 步：上传文件（如有需要）

对于图像编辑或参考图工作流：

1. 使用 file_path、base64_data 或 file_url 调用 upload_file → 获取 file_url（同步）
2. 将 file_url 用作 generate_image 的 image_urls 或 mask_url

支持格式：JPEG/PNG/GIF/WebP。最大 100MB。72 小时后过期。配额：100（默认）/500（VIP）。

第 3 步：理解意图

• 明确（"生成一张日落图"）→ 前往第 4 步
• 含糊（"帮我处理这张图片"）→ 询问："创建新图、编辑现有图，还是将其用作参考图？"

只在需要时询问必要信息。

第 4 步：收集参数

只询问缺少的信息：

参数	何时询问	说明
prompt	始终询问	用户想看到什么
model	对质量有要求时	默认使用 gpt-image-1.5。追求最佳效果时使用 gpt-4o-image，追求速度时使用 z-image-turbo
size	需要指定方向时	GPT 模型：1024x1024/1024x1536/1536x1024。其他模型：1:1/16:9/9:16 等
n	用户想要多个变体时	1–4 张图像
image_urls	编辑图像/参考图	最多 14 个 URL；会触发 i2i 模式
mask_url	局部编辑时	PNG 蒙版；仅适用于 gpt-4o-image

第 5 步：生成并轮询

1. 调用 generate_image → 告知用户："正在生成，预计需要约 X 秒。"
2. 每隔 3–5 秒轮询一次 check_task。报告进度百分比。
3. 连续 3 次显示 processing 后，告知用户："仍在处理中……"
4. 已完成： 分享 URL。"链接将在 24 小时后失效，请尽快保存。"
5. 失败： 显示错误及建议。如果可以重试，则提供重试选项。
6. 超时（5 分钟）： "耗时超出预期。任务 ID：{id}，请稍后再查看。"

错误处理

HTTP 错误

错误	操作
401	"API 密钥无法使用。请前往 evolink.ai/dashboard/keys 检查"
402	"余额不足。请前往 evolink.ai/dashboard/billing 充值"
429	"请求过于频繁，请等待 30 秒后重试"
503	"服务器繁忙，请在一分钟后重试"

任务错误（status: "failed"）

代码	是否重试？	操作
content_policy_violation	否	修改提示词（不要包含名人、NSFW 内容或暴力内容）
invalid_parameters	否	检查参数值是否符合模型限制
image_dimension_mismatch	否	调整图像尺寸，使其符合宽高比要求
image_processing_error	否	检查格式、大小和 URL 是否可访问
generation_timeout	是	重试；若再次发生，请简化提示词
quota_exceeded	是	充值
resource_exhausted	是	等待 30–60 秒后重试
service_error	是	1 分钟后重试
generation_failed_no_content	是	修改提示词后重试

完整错误参考：references/image-api-params.md

不使用 MCP 服务

使用 Evolink 的文件托管 API 上传图像（72 小时后过期）。curl 命令请参阅 references/file-api.md。

参考资料

• references/image-api-params.md — 完整 API 参数、全部 19 个模型、轮询策略和错误代码
• references/file-api.md — 文件托管 API（curl 上传/列出/删除）