Retro Diffusion Pixel Art

Retro Diffusion MCP 服务

使用任何支持 MCP 的 AI 助手，生成真正的像素艺术——精灵图、角色、动画和图块集。
像素与网格对齐、调色板可控、背景透明。不是“像素艺术风格”的图像，而是真正的像素艺术。

网站 · API 文档 · API 示例 · Discord

---

这是一个托管的远程 MCP 服务——无需在本地安装或运行任何内容。将客户端指向服务端点，添加 API 密钥，即可让助手浏览 90 多种像素艺术风格、免费估算费用、生成可直接用于游戏的美术素材，以及修复放大或模糊的像素艺术。

Endpoint:  https://mcp.retrodiffusion.ai/mcp     (Streamable HTTP)
Auth:      Authorization: Bearer <your API key>   (keys start with rdpk-)

托管的 MCP 端点保持向后兼容，默认使用 Retro Diffusion API v2。其服务端版本策略见 API 兼容性；MCP 客户端无需更改端点或身份验证设置。

获取 API 密钥（2 分钟）

1. 在 retrodiffusion.ai 创建免费账户——新账户附赠免费入门额度。
2. 打开 开发者工具，然后点击 创建 API 密钥。

按生成次数付费（每张图约 $0.01 起），预付费，无订阅，额度永不过期。费用估算始终免费，因此你的 Agent 可以在花费前查询任何内容的价格。

按客户端设置

Claude Code

claude mcp add --transport http retro-diffusion https://mcp.retrodiffusion.ai/mcp \
  --header "Authorization: Bearer rdpk-YOUR-KEY"

或者安装插件（内含服务和像素艺术工作流技能）：

/plugin marketplace add Retro-Diffusion/retro-diffusion-mcp
/plugin install pixel-art@retro-diffusion

Cursor

点击上方的 添加到 Cursor 徽章，然后替换 YOUR_API_KEY——或者添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "retro-diffusion": {
      "url": "https://mcp.retrodiffusion.ai/mcp",
      "headers": { "Authorization": "Bearer rdpk-YOUR-KEY" }
    }
  }
}

VS Code（GitHub Copilot）

添加到 mcp.json（命令面板 →“MCP：添加服务”→ HTTP）：

{
  "servers": {
    "retro-diffusion": {
      "type": "http",
      "url": "https://mcp.retrodiffusion.ai/mcp",
      "headers": { "Authorization": "Bearer rdpk-YOUR-KEY" }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "retro-diffusion": {
      "serverUrl": "https://mcp.retrodiffusion.ai/mcp",
      "headers": { "Authorization": "Bearer rdpk-YOUR-KEY" }
    }
  }
}

Claude Desktop

在 claude_desktop_config.json 中使用 mcp-remote：

{
  "mcpServers": {
    "retro-diffusion": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.retrodiffusion.ai/mcp",
        "--header",
        "Authorization: Bearer rdpk-YOUR-KEY"
      ]
    }
  }
}

其他客户端

任何支持 Streamable HTTP 的 MCP 客户端都可以使用：URL https://mcp.retrodiffusion.ai/mcp，请求头 Authorization: Bearer rdpk-YOUR-KEY。

工具

生成

工具	功能
create_inference	生成图像、动画（GIF/精灵图集）或图块集。返回托管 URL 和恢复用的 request_id；如需顶级质量，优先选择 RD Pro 风格
get_inference_result	恢复或刷新成功同步生成结果的签名输出 URL，不会重新生成或再次收费
start_inference_job	以异步作业启动生成 — 推荐用于动画和批量生成
get_inference_job	轮询异步作业的状态和结果
list_inference_jobs	列出近期异步作业 — 如果提交响应丢失，可找回 task_id，避免重新提交并被重复收费
estimate_inference_cost	运行生成前，免费查询任意生成的价格

生成操作并非幂等，在客户端超时或交付问题显现之前就可能已经收费。 如果 create_inference 成功，但缺少 output_urls 或 URL 已过期，请调用 get_inference_result(request_id)。切勿自动重复生成。MCP 不返回原始生成 base64 数据，以保持 Cursor 和其他工具上下文精简，并使用有时效限制的托管 URL 进行交付。

编辑 — 对任意图像进行后期处理

工具	功能
list_edit_tools	已启用的编辑工具及其字段、费用和限制
run_edit_tool	运行编辑工具：背景移除、调色板转换、颜色缩减、像素校正、旋转、K 中心点缩小（免费–$0.01）· 图像编辑、修复、扩图、无缝拼接（高级）
estimate_edit_tool_cost	免费估算任意编辑的费用/耗时
fix_pixel_art	免费从放大、柔化、AI 渲染或压缩过的像素画中恢复原生像素网格

风格

工具	功能
list_available_styles	实时风格目录，包含各风格的尺寸限制和功能
list_available_models	模型系列：RD Fast、RD Plus、RD Pro、RD Mini
get_style_usage	特定风格的使用指南和限制
create_user_style	根据参考图像创建自定义风格（RD Pro 模板）
update_user_style	修改你的一种自定义风格
delete_user_style	删除你的一种自定义风格

账户

工具	功能
authenticate	验证 API 密钥并将其关联到会话
get_balance	查看剩余预付余额和点数
get_service_status	子系统运行状况检查（无需身份验证）
logout	清除已存储的会话密钥

fix_pixel_art 接受 PNG 或 JPEG 格式的原始 base64 数据或数据 URL。图像尺寸必须至少为 16×16，且不超过 4 百万像素。标准引擎和神经网络引擎共用每个 API 密钥每分钟 10 次请求的限额；请求 JSON 上限为 900,000 字节，成功响应 JSON 上限为 850,000 字节。使用标准引擎进行原生 Rust 网格检测，或使用神经网络引擎并可选设置目标宽度和高度。

可以制作的内容

• 精灵图和角色 — 90 多种风格：肖像、游戏素材、等距视角、俯视视角、平台游戏、1 位色彩、Minecraft 物品／纹理、UI 元素、物品图集、角色转面图
• 动画 — 从起始帧生成行走／待机／跳跃／蹲伏／攻击循环、四角度行走循环、8 方向旋转、VFX、战斗精灵图；输出 GIF 或精灵图集
• 图块集 — Wang／blob 图块集、图块变体、单个图块、场景物件
• 风格一致的角色 — 使用 RD Pro 生成一次，然后在后续生成中将输出作为参考图（最多 9 张参考图）
• 编辑 — img2img、无缝平铺、透明背景、限制调色板的输出
• 像素修复 — 在检测到的原生分辨率下重建放大或模糊的像素艺术

连接后可以尝试以下示例提示词：

“列出可用于动画的像素艺术风格，然后估算制作 64×64 行走动画的费用。”

“生成一名 128×128 像素艺术骑士，他在篝火旁休息。使用 RD Pro 默认风格，背景透明。”

“创建一个 16×16 Wang 图块集：灰色石板路图块与葱郁草地自然衔接。”

“使用标准 Pixel Fixer，将这张放大的精灵图修复回原生像素网格。”

提示词技巧（重要）

• 只描述主体 — 提示词中不要写“像素艺术”；风格会负责渲染。
• 尺寸范围为 16×16 至 384×384，具体取决于风格；list_available_styles 会提供各风格的确切限制。
• 费用从约 $0.015（RD Fast）到每张 $0.18（RD Pro）不等；动画为 $0.07–$0.25；图块集为 $0.10。estimate_inference_cost 始终免费 — 请先使用它。
• 重用种子，即可在只更改提示词的同时，围绕同一构图进行迭代。

关于开发者

Retro Diffusion 由 Astropulse 打造。他在开发此工具前有七年自由职业像素艺术家的经验。包括 Replicate、Poe（Quora）和 Scenario 在内的工作室与平台都在生产环境中使用它。该工具由艺术家设计，并遵循艺术家级品质标准。

支持

• Discord 社区 — 解答最快，创始人每天都会活跃
• 完整 API 参考和可运行示例
• API v1/v2 兼容性 — 默认使用 v2，支持 v1，错误约定、请求 ID 和重试规则
• 服务状态（无需身份验证）

许可证

此仓库的内容（文档和清单）采用 MIT 许可证。Retro Diffusion 服务本身受其服务条款约束。