Agent Skill 集成指南

这篇文档是写给 AI Agent、Skill 作者和自动化工作流构建者看的。重点不是教人手动调用一个 REST 接口，而是帮助 Agent 把 Mew.Design 封装成可复用的设计能力。

当你要设计一个 Skill、工具、插件或工作流，让它代表用户创建视觉设计时，请使用 /open/api/design/generate。

Skill 应该做什么

一个 Mew.Design Skill 应该让 Agent 能把用户的设计需求转化为结构化设计生成请求。它应该：

识别用户想要视觉设计的场景，例如海报、传单、信息图、卡片、社交媒体图、名片或菜单。
当用户提到 logo、二维码、产品图、截图或风格参考，但没有提供可访问图片 URL 时，先向用户索取。
将用户需求整理成完整的 userQuery，包含准确文案、用途、受众、版式和风格要求。
通过 Open API 调用 Mew.Design。
返回生成后的 designUrl，简要说明生成了什么，并清楚解释失败原因。
保护 API 密钥，不在最终回复、日志、截图或生成文件中暴露。

场景	使用方式
正在编写 Agent Skill 或工具封装	`/open/api/design/generate`
客户端已经支持远程 MCP 服务	`https://api.mew.design/mcp`
人类用户手动创建设计	Mew.Design 工作台

给 Agent 的 Skill 安装说明

如果你的环境支持安装 Skill，可以创建一个名为 mew-design 的 Skill，触发描述建议如下：

name: mew-design
description: Use when the user asks to create, redesign, generate, or refine visual designs such as posters, flyers, infographics, social posts, cards, menus, business cards, banners, invitations, or marketing graphics with Mew.Design.

Skill 内容应包含以下工作流：

收集设计 brief：格式、受众、用途、准确文案、版式、风格、尺寸和必要素材。
如果用户提到 logo、二维码、产品图、截图或风格参考，但没有提供可访问图片 URL，先询问用户。
将 userQuery 写成完整设计 brief，并保留用户提供的准确文案。
必须出现在最终设计中的元素使用 assetImages。
只作为风格灵感的图片使用 referenceImage。
调用 POST https://api.mew.design/open/api/design/generate。
返回生成的设计 URL 和简短说明。
如果调用失败，说明是鉴权、积分、素材 URL、超时还是参数校验问题。

Skill 配置

Skill 需要一个 Mew.Design API 密钥。

让用户在 Account Settings 创建 API 密钥。
将密钥保存为 secret，例如 MEW_DESIGN_API_KEY。
调用接口时从运行环境读取该密钥。
不要把密钥硬编码进 Skill 指令或源码。

Skill 使用的 Open API 契约

Endpoint: POST https://api.mew.design/open/api/design/generate
Auth: X-Api-Key: $MEW_DESIGN_API_KEY 或 Authorization: Bearer $MEW_DESIGN_API_KEY
Content-Type: application/json
超时建议: 复杂设计允许最多 120 秒

请求参数

参数	类型	Skill 应如何使用
`userQuery`	string	必填。完整设计 brief，包含准确文案、内容层级、用途、受众、版式要求和限制。
`designConcept`	string	可选。浓缩视觉方向，例如颜色、字体、风格、情绪、版式方法。
`referenceImage`	object	可选。仅用于风格参考，包含直接图片 `url` 和可选 `tag`。
`width`	number	可选。1 到 5000 像素，默认 1080。
`height`	number	可选。`-1` 表示自适应高度，也可设置 100 到 5000 的固定高度。
`assetImages`	array	可选。必须整合进最终设计的图片，如 logo、二维码、产品图或截图。

Skill 调用示例

curl -X POST https://api.mew.design/open/api/design/generate \
  -H "X-Api-Key: $MEW_DESIGN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "为 Maple Street Cafe 创建一张 Instagram 图片。包含准确文案：\"Fall in Love with Every Sip\"、\"20% Off All Week\" 和 \"Available at Maple Street Cafe\"。使用温暖秋季配色、高级咖啡馆风格，并在左上角预留 logo 位置。",
    "designConcept": "温暖秋季咖啡馆活动，高级字体，舒适产品促销，干净社交媒体版式",
    "width": 1080,
    "height": 1080
  }'

成功响应

{
  "flag": true,
  "statusCode": "B000000",
  "message": "success",
  "data": {
    "success": true,
    "designUrl": "https://...",
    "message": "Visual design generated successfully."
  }
}

Skill 应把 data.designUrl 返回给用户，并简要说明生成结果。

Agent 写提示词规则

调用 Skill 时，Agent 应该写设计 brief，而不是一句模糊图片提示词。

好的 userQuery 包含：

输出格式和渠道
目标受众和用途
要包含的准确文案
信息层级和版式优先级
品牌颜色、情绪或字体风格
必须出现的素材
限制条件，例如“不要改变 logo”或“保持二维码可读”

不好的 userQuery：

做一张酷一点的海报。

更好的 userQuery：

创建一张竖版学生爵士夜活动海报。包含准确标题 "Midnight Brass"，日期 "June 18"，时间 "8 PM"，地点 "Blue Hall"，CTA "Reserve your seat"。使用深海军蓝和金色配色，大号优雅字体，铜管乐器元素，并保持日期和地点在远处也易读。

Skill 错误处理

Skill 应把失败原因转成可执行提示：

缺少或无效密钥： 让用户配置 MEW_DESIGN_API_KEY。
积分不足： 告诉用户账户需要更多积分，本次请求无法运行。
素材 URL 无效： 请求用户提供直接公开图片 URL。
超时： 建议降低复杂度、减少素材或缩小固定尺寸。
参数校验错误： 指出需要修正的字段。

可选 MCP 配置

如果 Agent 平台已经支持远程 MCP 服务，用户也可以直接配置 Mew.Design：

Server URL: https://api.mew.design/mcp
Tool name: generateDesign
推荐鉴权 Header: X-Api-Key: your-api-key
兼容 Bearer 鉴权: Authorization: Bearer your-api-key

{
  "mcpServers": {
    "mew-design": {
      "url": "https://api.mew.design/mcp",
      "headers": {
        "X-Api-Key": "your-api-key"
      }
    }
  }
}

积分说明

设计生成遵循当前 Mew.Design 积分规则：

新设计生成：10 积分
工作台内设计修改：5 积分
高级图像模型：2-60 积分，取决于模型和设置
下载：不额外扣积分

在公开 Skill 描述中写死成本前，请以 pricing 页面为准。