API Avatrix · MCP e REST v1
Conecte a Avatrix ao Claude, ao Cursor ou ao seu próprio produto e gere influencer IA, imagem realista e vídeo UGC — sem cartão gringo, sem sair do seu fluxo. No agente, nem token precisa.
Usa os créditos do seu plano Avatrix. Paga com Pix.
Cole a URL do MCP no agente. O Connect abre o login da Avatrix (Google ou e-mail) e uma tela que diz o que o agente vai poder fazer. O agente ganha a Avatrix inteira: catálogo e cotação, upload, biblioteca, personagens, imagem e edição, vídeo, Marketing Studio, voz, lote e o Chat IA com seus agentes.
No claude.ai, em 3 passos
https://avatrix.io/mcpClaude Code: claude mcp add --transport http avatrix https://avatrix.io/mcp
Cursor: Settings → MCP → Add → cole a mesma URL.
ChatGPT: Configurações → Conectores → adicionar a mesma URL (conta com conector personalizado habilitado).
Não precisa de token
Nada de chave pra copiar, colar ou guardar. Você entra com a conta Avatrix que já tem e usa os créditos que já pagou.
O custo é cotado antes
Toda tool de geração aceita get_cost: true e devolve o preço sem gerar nem cobrar. Peça a cotação, depois mande gerar.
n8n e backend próprio continuam no Bearer av_ da API REST, logo abaixo.
Cada ferramenta vira uma chamada. Sem clicar em botão.
"Cria 8 fotos da Valentina: morena, 24 anos, olhos claros, expressões variadas, fundo limpo. Rosto consistente em todas."
Gera a persona com rosto travado — as 8 fotos parecem tiradas no mesmo dia, pela mesma pessoa.
POST /generate/influencer"Foto vertical da Valentina segurando o produto, fundo de cozinha clean, luz natural, estilo lifestyle."
Insere a modelo na cena com o produto — sem sessão de fotos, sem produtora.
POST /generate/image"Vídeo vertical de 15s: a Valentina fala sobre o produto, tom natural como uma resenha."
Gera o UGC com a persona definida, pronto pra veicular em anúncio.
POST /generate/video-ugc"Gera 30 variações da foto de perfil da Valentina: diferentes ângulos, emoções e fundos. Rosto idêntico."
Produz o lote completo — você escolhe as melhores.
POST /generate/influencer (batch)"Anima essa foto da Valentina num vídeo de 5s: movimento suave, olhar pra câmera, sem corte."
Transforma a imagem estática num vídeo fluido — sem câmera, sem set.
POST /generate/video-creativeA API não tem cobrança separada; cada capacidade respeita o plano e o rollout publicado.
Influencer IA
Persona consistente: rosto travado em múltiplas fotos
Geração de imagem
Foto realista, produto, editorial, lifestyle
Vídeo UGC
Vídeo vertical com persona IA, tom natural
Vídeo criativo
Animação de foto, vídeo de persona em movimento
Edição de imagem
Ajuste de imagem existente com instrução em texto
Remoção de fundo
Background transparente automático
Melhoria de pele
Refinamento realista sem sobre-editar
Upscale
Aumentar resolução sem perder detalhe
Aqui não tem dólar, não tem VAT internacional e não tem conta separada numa plataforma gringa. Você conecta com a conta Avatrix que já tem, usa os créditos do plano que já pagou — e os créditos não expiram.
Base URL: https://avatrix.io/api/v1
Auth: Bearer token (av_...) — gere em /account/tokens
curl -X POST https://avatrix.io/api/v1/generate/image \
-H "Authorization: Bearer av_seu_token" \
-H "Content-Type: application/json" \
-d '{"prompt": "foto realista de influencer, fundo clean, luz natural"}'Resposta 202 com um taskId — a geração é assíncrona. Faça polling em GET /tasks/{taskId} ou configure um webhook.
Preciso de token pra conectar no Claude?
Não. No MCP você cola a URL, faz login na Avatrix e clica em Permitir — o agente passa a usar a sua conta e os seus créditos, sem nenhuma chave pra copiar ou guardar. Token av_ só é necessário na API REST (n8n, backend próprio), e você gera em /account/tokens.
Quais gerações estão disponíveis via API?
Influencer IA, imagem, vídeo UGC, vídeo criativo, edição de imagem, remoção de fundo, melhoria de pele e upscale. O catálogo da API é o mesmo do app.
Como sei o custo antes de gerar?
Você pergunta antes de gastar. Toda tool de geração do MCP aceita get_cost: true e devolve só a cotação, sem criar nada nem cobrar nada — e get_credits mostra o saldo da conta. O preço é o mesmo do app, sem sobretaxa de API. Na REST, o consumo por endpoint está em /api/docs.
Como funciona a geração assíncrona?
Você faz POST no endpoint de geração e recebe um taskId. Depois faz GET /tasks/{taskId} pra checar o status — ou configura um webhook pra receber o resultado quando ficar pronto.
Dá pra integrar a Avatrix num produto meu e oferecer pra clientes?
Sim. A API é pensada pra isso: você conecta, gera pelo próprio workflow e entrega pra cliente. Os termos estão em /termos.
Continue lendo