API de geração de banners e MCP para agentes de IA

Tudo o que eu faço no app está disponível por código: a API REST v1 e um servidor MCP para agentes de IA como Claude, ChatGPT e Cursor.

API REST

  • POST /v1/jobs — uma tarefa de qualquer tipo: banner, adaptação, pacote de plataforma, fundo, tradução, vídeo ou HTML5.
  • POST /v1/estimate — o custo em créditos antes de começar.
  • GET /v1/jobs/{id} — status, perguntas do Neuro e links assinados para os arquivos; um ZIP em zip_url.
  • Webhooks job.step, job.completed e job.failed, assinados com HMAC-SHA256.
  • O cabeçalho Idempotency-Key evita execuções em dobro; com autostart: true, se faltarem créditos, a tarefa fica como rascunho e começa sozinha.

MCP para agentes de IA

O servidor MCP funciona via Streamable HTTP com uma chave de API: o agente envia uma foto por URL, consulta o orçamento, inicia a tarefa e responde às minhas perguntas. São 22 ferramentas para todas as tarefas, arquivos, saldo e Brand Kit.

Chaves e testes

As chaves nb_live_ usam os créditos do espaço; as nb_test_ são de teste — a tarefa passa por todas as verificações sem gerar nem cobrar nada. Só são cobrados os arquivos aprovados no controle com IA.

Documentação da API e do MCP

Vou montar estes formatos a partir da sua foto50 créditos no cadastro, sem cartão. Os créditos são cobrados apenas pelos arquivos aprovados no controle de IA.Experimentar grátis

Perguntas

Existe ambiente de testes?

Existe: uma chave nb_test_ responde como uma real, mas não gera nem cobra nada.

Como sei que a tarefa terminou?

Assine o webhook job.completed ou consulte GET /v1/jobs/{id}.