Retro Diffusion Pixel Art

Pixel art real no seu assistente de IA: sprites, animações, tilesets e ferramentas de edição via a API Retro Diffusion.

Documentação

Retro Diffusion MCP Server

Gere pixel art de verdade — sprites, personagens, animações e tilesets — a partir de qualquer assistente de IA compatível com MCP.
Pixels alinhados à grade, paletas controladas, fundos transparentes. Não são imagens "estilo pixel art". É o verdadeiro.

Site · Documentação da API · Exemplos de API · Discord

Este é um servidor MCP remoto e hospedado — nada para instalar ou executar localmente. Aponte seu cliente para o endpoint, adicione sua chave de API, e seu assistente pode navegar por mais de 90 estilos de pixel art, estimar custos gratuitamente, gerar arte pronta para jogos e reparar pixel art ampliada ou suavizada.

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

O endpoint MCP hospedado permanece compatível com versões anteriores e usa por padrão a Retro Diffusion API v2. Sua política de versão no lado do servidor é descrita em compatibilidade da API; clientes MCP não alteram seu endpoint ou configurações de autenticação.

Obtenha uma chave de API (2 minutos)

Crie uma conta gratuita em retrodiffusion.ai — novas contas incluem créditos iniciais gratuitos.
Abra Ferramentas do desenvolvedor e clique em Criar chave de API.

O preço é por geração (a partir de ~$0,01 por imagem), pré-pago, sem assinatura, e os créditos nunca expiram. A estimativa de custo é sempre gratuita, então seu agente pode verificar o preço de qualquer coisa antes de gastar.

Configuração por cliente

Claude Code

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

Ou instale o plugin (inclui o servidor mais uma habilidade de fluxo de trabalho de pixel art):

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

Cursor

Clique no selo Adicionar ao Cursor acima e substitua YOUR_API_KEY — ou adicione a ~/.cursor/mcp.json:

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

VS Code (GitHub Copilot)

Adicione a mcp.json (Paleta de Comandos → "MCP: Adicionar Servidor" → HTTP):

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

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

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

Claude Desktop

Use mcp-remote em claude_desktop_config.json:

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

Qualquer outro

Qualquer cliente MCP que fale Streamable HTTP funciona: URL https://mcp.retrodiffusion.ai/mcp, cabeçalho Authorization: Bearer rdpk-YOUR-KEY.

Ferramentas

Gerar

Ferramenta	O que faz
`create_inference`	Gera imagens, animações (GIF/folha de sprites) ou tilesets. Retorna URLs hospedadas e um `request_id` de recuperação; prefira estilos RD Pro para qualidade máxima
`get_inference_result`	Recupera ou atualiza URLs de saída assinadas para uma geração síncrona bem-sucedida sem gerar ou cobrar novamente
`start_inference_job`	Inicia a geração como um trabalho assíncrono — recomendado para animações e lotes
`get_inference_job`	Consulta um trabalho assíncrono para status e resultados
`list_inference_jobs`	Lista seus trabalhos assíncronos recentes — recupere um `task_id` após uma resposta de envio perdida em vez de reenviar e ser cobrado duas vezes
`estimate_inference_cost`	Gratuito verificação de preço para qualquer geração antes de executá-la

A geração não é idempotente e pode cobrar antes que um timeout do cliente ou problema de entrega seja visível. Se create_inference for bem-sucedido, mas seus output_urls estiverem ausentes ou expirados, chame get_inference_result(request_id). Nunca repita a geração automaticamente. O MCP omite o base64 bruto da geração para manter os contextos do Cursor e de outras ferramentas compactos, e usa URLs hospedadas de curta duração para entrega.

Editar — pós-processe qualquer imagem

Ferramenta	O que faz
`list_edit_tools`	Habilita ferramentas de edição com seus campos, custos e limites
`run_edit_tool`	Executa uma ferramenta de edição: removedor de fundo, conversor de paleta, redutor de cores, correção de pixels, rotação, redução de escala K-centroid (grátis–$0,01) · edição de imagem, inpainting, outpainting, costura de tiles (premium)
`estimate_edit_tool_cost`	Gratuito estimativa de custo/duração para qualquer edição
`fix_pixel_art`	Gratuito recuperação da grade de pixels nativa de pixel art ampliada, suavizada, renderizada por IA ou comprimida

Estilos

Ferramenta	O que faz
`list_available_styles`	Catálogo de estilos ao vivo com limites de tamanho e capacidades por estilo
`list_available_models`	As famílias de modelos: RD Fast, RD Plus, RD Pro, RD Mini
`get_style_usage`	Orientações de uso e restrições para um estilo específico
`create_user_style`	Cria um estilo personalizado a partir de uma imagem de referência (modelo RD Pro)
`update_user_style`	Modifica um dos seus estilos personalizados
`delete_user_style`	Remove um dos seus estilos personalizados

Conta

Ferramenta	O que faz
`authenticate`	Valida uma chave de API e a anexa à sessão
`get_balance`	Verifica o saldo pré-pago restante e os créditos
`get_service_status`	Verificação de saúde do subsistema (sem autenticação necessária)
`logout`	Limpa a chave de sessão armazenada

fix_pixel_art aceita PNG ou JPEG como base64 bruto ou URL de dados. As imagens devem ter pelo menos 16×16 e no máximo 4 megapixels. Padrão e neural compartilham um limite de 10 solicitações/minuto por chave de API; o JSON da solicitação é limitado a 900.000 bytes e o JSON da resposta bem-sucedida a 850.000 bytes. Use o mecanismo padrão para detecção nativa de grade em Rust ou o mecanismo neural com valores opcionais de largura e altura alvo.

O que você pode criar

Sprites e personagens — mais de 90 estilos: retratos, ativos de jogos, isométricos, top-down, plataforma, 1-bit, itens/texturas do Minecraft, elementos de UI, folhas de itens, rotações de personagem
Animações — ciclos de caminhar/parado/pular/agachar/atacar a partir de um quadro inicial, ciclos de caminhada em quatro ângulos, rotações em 8 direções, VFX, sprites de batalha; saída em GIF ou folha de sprites
Tilesets — tilesets Wang/blob, variações de tiles, tiles individuais, objetos de cena
Personagens consistentes — gere uma vez com RD Pro e depois passe a saída como imagem de referência em gerações subsequentes (até 9 referências)
Edições — img2img, costura sem emendas, fundos transparentes, saída com paleta restrita
Reparo de pixels — reconstrua pixel art ampliada ou suavizada em sua resolução nativa detectada

Exemplos de prompts para testar após conectar:

"Liste os estilos de pixel art disponíveis para animações e depois estime quanto custaria uma animação de caminhada de 64×64."

"Gere um cavaleiro de pixel art de 128×128 descansando perto de uma fogueira, estilo padrão RD Pro, fundo transparente."

"Crie um tileset Wang de 16×16: tiles de caminho de pedra cinza se misturando com grama exuberante."

"Corrija este sprite ampliado de volta à sua grade de pixels nativa usando o Pixel Fixer padrão."

Dicas de prompts (importante)

Descreva apenas o assunto — nunca escreva "pixel art" no prompt; o estilo cuida da renderização.
Os tamanhos variam de 16×16 a 384×384 dependendo do estilo; list_available_styles fornece limites exatos por estilo.
Os custos variam de ~$0,015 (RD Fast) a $0,18/imagem (RD Pro); animações $0,07–$0,25; tilesets $0,10. estimate_inference_cost é sempre gratuito — use-o primeiro.
Reutilize uma semente para iterar na mesma composição alterando apenas o prompt.

Quem faz isso

A Retro Diffusion é construída pela Astropulse — um pixel artist com sete anos de experiência freelance antes de construir a ferramenta — e é usada em produção por estúdios e plataformas incluindo Replicate, Poe (Quora) e Scenario. É projetada por artistas e mantida com padrões de qualidade de nível artístico.

Suporte

Comunidade no Discord — respostas mais rápidas, o fundador é ativo diariamente
Referência completa da API e exemplos executáveis
Compatibilidade API v1/v2 — v2 padrão, suporte a v1, contrato de erros, IDs de solicitação e regras de repetição
Status do serviço (sem autenticação necessária)

Licença

O conteúdo deste repositório (documentação e manifestos) é licenciado sob MIT. O serviço Retro Diffusion em si é regido pelos seus Termos de Serviço.