Aiimgcombiner Mcp Skill

AI Image Combiner — 远程 MCP 服务与 Claude 技能

将多张照片合并、融合并生成一张 AI 图像。 免费 API · 支持 MCP · 无需本地 GPU · 兼容 Claude、Cursor 和任何 MCP 客户端

---

什么是 AI Image Combiner？

AI Image Combiner 是一项基于云的 AI 照片编辑服务，可使用生成式 AI 将两张或更多照片合并为一张连贯的成品图像。

无论你需要制作婚纱照拼贴、AI 情侣头像、发型预览，还是生日卡片涂鸦，都可以通过简单的 REST API，或直接在 AI 助手中使用 MCP（模型上下文协议）集成来完成。

此代码库包含：

资源	路径	描述
MCP 服务清单	mcp/server.json	即插即用的远程 MCP 配置
Claude 技能	skill/ai-img-combiner/SKILL.md	可直接安装的 Claude Code 技能
cURL 示例	examples/curl.sh	可运行的 REST API 参考示例

---

主要功能

• AI 图像合并 — 使用生成模型将 2 张或更多照片合并为一张
• 风格提示词 — 用自然语言描述如何融合图像
• 普通与高品质 — 为每项任务选择处理质量
• 异步任务队列 — 提交任务并轮询结果；无需阻塞调用
• API Key 身份验证 — 按用户计费的额度系统，支持审计和撤销
• 远程 MCP — 无需本地安装；通过 HTTPS 兼容任何 MCP 客户端
• 可流式传输的 HTTP 传输 — 符合 MCP 2025 协议标准

---

快速开始 — MCP（Claude / Cursor）

添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "aiimgcombiner": {
      "url": "https://aiimgcombiner.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

1. 在 aiimgcombiner.com → Settings → API Keys 中获取免费 API key
2. 将上述配置粘贴到 MCP 客户端中
3. 使用自然语言：“将这两张照片合并成一张情侣头像”

---

快速开始 — REST API（curl）

export API_KEY="your_api_key_here"

# 1. Upload image — returns CDN URL
UPLOAD=$(curl -sS -X POST https://aiimgcombiner.com/api/open/v1/upload \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "photo.webp",
    "mimeType": "image/webp",
    "dataBase64": "<BASE64_IMAGE>"
  }')
IMAGE_URL=$(echo "$UPLOAD" | jq -r '.url')

# 2. Submit combine task — returns jobId
TASK=$(curl -sS -X POST https://aiimgcombiner.com/api/open/v1/tasks/image-combine \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"payload\": {
      \"imageUrls\": [\"$IMAGE_URL\", \"https://cdn.example.com/b.webp\"],
      \"stylePrompt\": \"Blend these two portraits into a couple avatar with soft lighting.\",
      \"quality\": \"normal\"
    }
  }")
JOB_ID=$(echo "$TASK" | jq -r '.jobId')

# 3. Poll status until completed
curl -sS "https://aiimgcombiner.com/api/open/v1/tasks/$JOB_ID" \
  -H "Authorization: Bearer $API_KEY"

完整的可运行示例：examples/curl.sh

---

API 参考

端点

方法	端点	描述
POST	/api/open/v1/upload	上传 base64 图像并获取 CDN URL
POST	/api/open/v1/tasks/image-combine	提交合并任务并获取 jobId
GET	/api/open/v1/tasks/{taskId}	轮询任务状态和结果

MCP 工具（使用 MCP 客户端时）

工具	描述
upload_image	上传图像并返回 url
combine_images	提交任务并返回 jobId
get_task_status	轮询任务；完成后返回 resultUrl

状态码

代码	含义
401	API Key 无效或缺失
402	额度不足
404	未找到任务，或此密钥不拥有该任务
500	服务器端错误

---

工具页面

aiimgcombiner.com 提供的所有工具：

工具	URL
合并两张照片	/combine-two-photos
照片拼贴制作工具	/photo-collage-maker
婚纱照合并工具	/wedding-photo-combiner
AI 情侣头像制作工具	/ai-couple-avatar-maker
AI 发型更换工具	/ai-hairstyle-changer
AI 生日涂鸦制作工具	/ai-birthday-doodle-maker

---

定价

方案	点数	功能
免费版	注册时赠送入门点数	所有工具，普通画质
Pro（月付 / 年付）	每月补充	优先队列，高画质
终身版	一次性购买	包含未来推出的所有工具

→ aiimgcombiner.com/pricing

---

资源

资源	URL
官方文档	aiimgcombiner.com/docs
博客与教程	aiimgcombiner.com/blog
更新日志	aiimgcombiner.com/changelog

---

技术详情

• MCP 协议：2025-12-11，streamable-http 传输方式
• 身份验证：Authorization: Bearer <API_KEY>
• 基础 URL：https://aiimgcombiner.com
• MCP 端点：https://aiimgcombiner.com/api/mcp

---

最佳实践

• 上传前将图片压缩至 ≤2 MB，以缩短排队时间
• 每隔 2–5 秒轮询一次；避免频繁轮询
• 仅在最终输出时使用 quality: "high"；"normal" 速度更快
• 及时保存 resultUrl — CDN 链接可能会在 24 小时后过期
• 为每个项目使用单独的 API Keys，便于清晰审计

---

仓库结构

aiimgcombiner-mcp-skill/
├── README.md
├── mcp/
│   └── server.json                 # MCP server manifest
├── skill/
│   └── ai-img-combiner/
│       └── SKILL.md                # Claude Code skill definition
└── examples/
    └── curl.sh                     # Runnable curl example

---

由 aiimgcombiner.com 提供支持