Retro Diffusion Pixel Art

Arte pixel art real en tu asistente de IA: sprites, animaciones, tilesets y herramientas de edición a través de la API de Retro Diffusion.

Documentación

Retro Diffusion

Servidor MCP de Retro Diffusion

Genera pixel art real — sprites, personajes, animaciones y tilesets — desde cualquier asistente de IA compatible con MCP.
Píxeles alineados a la cuadrícula, paletas controladas, fondos transparentes. No son imágenes "estilo pixel art". Es lo auténtico.

Sitio web · Documentación de API · Ejemplos de API · Discord

Add to Cursor MIT License Streamable HTTP


Este es un servidor MCP remoto y alojado — no hay nada que instalar ni ejecutar localmente. Apunta tu cliente al endpoint, añade tu clave de API, y tu asistente podrá explorar más de 90 estilos de pixel art, estimar costos de forma gratuita, generar arte listo para juegos y reparar pixel art ampliado o suavizado.

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

El endpoint MCP alojado sigue siendo compatible con versiones anteriores y usa por defecto la API v2 de Retro Diffusion. Su política de versiones del lado del servidor se describe en compatibilidad de API; los clientes MCP no cambian su endpoint ni su configuración de autenticación.

Obtén una clave de API (2 minutos)

  1. Crea una cuenta gratuita en retrodiffusion.ai — las cuentas nuevas incluyen créditos iniciales gratuitos.
  2. Abre Herramientas de desarrollador y haz clic en Crear clave de API.

El precio es por generación (desde ~$0.01 por imagen), prepagado, sin suscripción y los créditos nunca caducan. La estimación de costos siempre es gratuita, así que tu agente puede consultar el precio de cualquier cosa antes de gastar.

Configuración por cliente

Claude Code

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

O instala el plugin (incluye el servidor más una habilidad de flujo de trabajo para pixel art):

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

Cursor

Haz clic en la insignia Añadir a Cursor de arriba y luego reemplaza YOUR_API_KEY — o añádelo a ~/.cursor/mcp.json:

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

VS Code (GitHub Copilot)

Añádelo a mcp.json (Paleta de comandos → "MCP: Añadir servidor" → HTTP):

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

Windsurf

Añádelo a ~/.codeium/windsurf/mcp_config.json:

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

Claude Desktop

Usa mcp-remote en claude_desktop_config.json:

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

Cualquier otro

Cualquier cliente MCP que hable Streamable HTTP funciona: URL https://mcp.retrodiffusion.ai/mcp, cabecera Authorization: Bearer rdpk-YOUR-KEY.

Herramientas

Generar

HerramientaQué hace
create_inferenceGenera imágenes, animaciones (GIF/hoja de sprites) o tilesets. Devuelve URLs alojadas y un request_id de recuperación; prefiere los estilos RD Pro para máxima calidad
get_inference_resultRecupera o actualiza URLs de salida firmadas para una generación síncrona exitosa sin volver a generar ni cobrar
start_inference_jobInicia la generación como un trabajo asíncrono — recomendado para animaciones y lotes
get_inference_jobConsulta un trabajo asíncrono para ver su estado y resultados
list_inference_jobsLista tus trabajos asíncronos recientes — recupera un task_id después de una respuesta de envío perdida en lugar de reenviar y pagar dos veces
estimate_inference_costGratis verificación de precio para cualquier generación antes de ejecutarla

La generación no es idempotente y puede cobrar antes de que se vea un tiempo de espera del cliente o un problema de entrega. Si create_inference tiene éxito pero sus output_urls faltan o han caducado, llama a get_inference_result(request_id). Nunca repitas la generación automáticamente. El MCP omite el base64 de generación en bruto para mantener compactos los contextos de Cursor y otras herramientas, y usa URLs alojadas de corta duración para la entrega.

Editar — post-procesa cualquier imagen

HerramientaQué hace
list_edit_toolsHabilita herramientas de edición con sus campos, costos y límites
run_edit_toolEjecuta una herramienta de edición: eliminador de fondo, conversor de paleta, reductor de color, corrección de píxeles, rotación, reducción de escala K-centroide (gratis–$0.01) · edición de imagen, inpainting, outpainting, mosaico sin costuras (premium)
estimate_edit_tool_costGratis estimación de costo/duración para cualquier edición
fix_pixel_artGratis recuperación de la cuadrícula de píxeles nativa a partir de pixel art ampliado, suavizado, renderizado por IA o comprimido

Estilos

HerramientaQué hace
list_available_stylesCatálogo de estilos en vivo con límites de tamaño y capacidades por estilo
list_available_modelsLas familias de modelos: RD Fast, RD Plus, RD Pro, RD Mini
get_style_usageGuía de uso y restricciones para un estilo específico
create_user_styleCrea un estilo personalizado a partir de una imagen de referencia (plantilla RD Pro)
update_user_styleModifica uno de tus estilos personalizados
delete_user_styleElimina uno de tus estilos personalizados

Cuenta

HerramientaQué hace
authenticateValida una clave de API y la adjunta a la sesión
get_balanceConsulta el saldo prepagado restante y los créditos
get_service_statusVerificación de salud del subsistema (sin autenticación requerida)
logoutBorra la clave de sesión almacenada

fix_pixel_art acepta PNG o JPEG como base64 en bruto o una URL de datos. Las imágenes deben tener al menos 16×16 y no más de 4 megapíxeles. El estándar y el neuronal comparten un límite de 10 solicitudes/minuto por clave de API; el JSON de solicitud está limitado a 900,000 bytes y el JSON de respuesta exitosa a 850,000 bytes. Usa el motor estándar para detección nativa de cuadrícula en Rust o el motor neuronal con valores opcionales de ancho y alto objetivo.

Lo que puedes crear

  • Sprites y personajes — más de 90 estilos: retratos, activos de juego, isométricos, vista superior, plataformas, 1-bit, objetos/texturas de Minecraft, elementos de interfaz, hojas de objetos, giros de personaje
  • Animaciones — ciclos de caminar/esperar/saltar/agacharse/atacar desde un fotograma inicial, ciclos de caminata en cuatro ángulos, rotaciones de 8 direcciones, efectos visuales, sprites de batalla; salida en GIF u hoja de sprites
  • Tilesets — tilesets Wang/blob, variaciones de tiles, tiles individuales, objetos de escena
  • Personajes consistentes — genera una vez con RD Pro y luego pasa la salida como imagen de referencia en generaciones posteriores (hasta 9 referencias)
  • Ediciones — img2img, mosaico sin costuras, fondos transparentes, salida restringida por paleta
  • Reparación de píxeles — reconstruye pixel art ampliado o suavizado en su resolución nativa detectada

Ejemplos de indicaciones para probar una vez conectado:

"Lista los estilos de pixel art disponibles para animaciones y luego estima cuánto costaría una animación de caminar de 64×64."

"Genera un caballero de pixel art de 128×128 descansando junto a una fogata, estilo RD Pro predeterminado, fondo transparente."

"Crea un tileset Wang de 16×16: tiles de camino de piedra gris que se mezclan con hierba exuberante."

"Arregla este sprite ampliado de vuelta a su cuadrícula de píxeles nativa usando el Corregidor de Píxeles estándar."

Consejos para indicaciones (importante)

  • Describe solo el sujeto — nunca escribas "pixel art" en la indicación; el estilo se encarga del renderizado.
  • Los tamaños van de 16×16 a 384×384 según el estilo; list_available_styles da los límites exactos por estilo.
  • Los costos van de ~$0.015 (RD Fast) a $0.18/imagen (RD Pro); animaciones $0.07–$0.25; tilesets $0.10. estimate_inference_cost siempre es gratis — úsalo primero.
  • Reutiliza una semilla para iterar sobre la misma composición cambiando solo la indicación.

Quién hace esto

Retro Diffusion está construido por Astropulse — un artista de píxeles con siete años de experiencia freelance antes de construir la herramienta — y se usa en producción por estudios y plataformas como Replicate, Poe (Quora) y Scenario. Está diseñado por artistas y se mantiene con estándares de calidad de nivel artístico.

Soporte

Licencia

El contenido de este repositorio (documentación y manifiestos) está licenciado bajo MIT. El servicio de Retro Diffusion en sí se rige por sus Términos de servicio.