Avatrix agora tem API: criar influencer IA e vídeo UGC

A Avatrix agora tem uma API pública. Dá pra gerar influencer IA, imagem, vídeo UGC, vídeo criativo e voz direto por código — ou plugando num n8n, num Make ou no Claude — sem nem abrir o site. A base é https://avatrix.io/api/v1, a autenticação é por um token que você gera na conta, e por baixo roda a mesma engine que mais de 5.000 criadores já usam por dentro da plataforma. Este post é o mapa: o primeiro request em três linhas, os endpoints, quanto custa em crédito e pra quem isso serve.

O que dá pra fazer com a API da Avatrix?

Dá pra rodar por código quase tudo que a plataforma faz: gerar imagem, criar uma influencer IA, animar em vídeo UGC, fazer vídeo criativo, gerar voz e ainda editar imagem, trocar personagem e melhorar pele. A API expõe a mesma engine do app — Veo 3.1, Kling 3.0, Seedream 4.5 e Nano Banana Pro. A única coisa que muda é que você dispara a geração de um servidor seu, não da tela.

A diferença não é a qualidade, é o controle. No site você cria uma de cada vez, na mão. Pela API você roda em lote, no horário que quiser, dentro do seu próprio fluxo. É o que separa "criar conteúdo" de "ter uma esteira de conteúdo rodando sozinha".

A base de uso já existe e é grande. São 5.674 criadores na plataforma e mais de 5.000 conteúdos gerados desde o lançamento, com 82% das gerações concluindo com sucesso (dados da própria Avatrix, snapshot do banco em junho de 2026). A API não é um produto novo no escuro — é a mesma máquina rodada por gente de verdade, agora aberta por request.

Como faço o primeiro request? (quickstart em 3 linhas)

Você faz o primeiro request em três passos: gera um token na conta, manda um POST pra /generate/image com esse token, e consulta o resultado pelo taskId. Não tem SDK obrigatório nem instalação — é HTTP puro, funciona com curl, com a linguagem que você já usa ou com um nó de HTTP no n8n.

Passo 1 — gere o token. O token de acesso (ou PAT) é a chave que identifica sua conta em cada chamada da API. Na sua conta, vá em avatrix.io/account/tokens e crie um escolhendo os escopos (por exemplo generate:image). Ele começa com av_ e aparece uma vez só — copie e guarde num lugar seguro. É o que vai no cabeçalho de todo request.

Passo 2 — mande a geração. Um POST pra /generate/image com o token, o modelo e o prompt:

curl -X POST https://avatrix.io/api/v1/generate/image \
  -H "Authorization: Bearer av_SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{"model": "nano-banana-pro", "prompt": "uma influencer brasileira numa cafeteria, luz natural de janela"}'

A resposta vem na hora, mas não é a imagem — é o protocolo da tarefa:

{ "success": true, "data": { "taskId": "<id-da-tarefa>", "status": "queued" } }

Passo 3 — pegue o resultado. Com o taskId, consulte a tarefa até ela ficar pronta:

curl https://avatrix.io/api/v1/tasks/SEU_TASK_ID \
  -H "Authorization: Bearer av_SEU_TOKEN_AQUI"

Quando o status virar completed, a resposta traz a resultUrl com o arquivo gerado. É esse o ciclo de toda geração — e o próximo H2 explica por que ele é assim.

Como funciona a geração: taskId, polling e webhook?

Toda geração na API da Avatrix é assíncrona. Você manda o pedido e recebe na hora um 202 com taskId e status: queued — não a imagem ou o vídeo. Faz sentido: gerar vídeo leva tempo, e segurar a conexão aberta esperando seria frágil. Em vez disso, a API te dá um número de protocolo e segue trabalhando.

A partir daí, dois caminhos. O primeiro é o polling: você consulta GET /tasks/:id de tempos em tempos, e o status caminha de pending pra submitted, processing e enfim completed (ou failed). Quando completa, vem a resultUrl; quando falha, vem a mensagem do erro. Simples de implementar, bom pra começar.

O segundo é o webhook, mais limpo pra volume. Você passa uma callbackUrl na hora de criar a geração. Quando a tarefa termina, a Avatrix faz um POST pro seu endereço com o link do resultado e o crédito gasto. Aí você não fica perguntando "já ficou pronto?" — o resultado chega sozinho. O jeito mais robusto é usar webhook e deixar o polling como rede de segurança.

Quais são os endpoints da API?

Os endpoints se dividem em três famílias de geração — imagem, vídeo e áudio — mais as rotas de leitura (saldo, status, perfil). Cada token carrega escopos, e o escopo libera o grupo de endpoints. Quem só vai gerar imagem cria um token com generate:image e pronto. Esta é a parte que mais interessa:

Tem mais rotas de leitura (perfil, assinaturas, pedidos), e a lista completa com o corpo de cada request mora na doc oficial em avatrix.io/api/docs — essa é a fonte viva, sempre à frente de qualquer post. Duas rotas públicas não pedem token: GET /health, pra checar se a API está no ar, e GET /plans, que devolve os planos e pacotes.

Quanto custa cada geração em crédito?

Você paga por crédito, do mesmo jeito que paga usando o site — a API não cobra à parte. Rodando a própria API na prática em junho de 2026, deu pra medir o custo real de cada geração olhando o crédito que sai do saldo:

O vídeo varia porque depende do modelo e da duração — o video-creative aceita modelos diferentes (de um Seedance mais econômico a um Veo mais pesado), e a conta muda com isso. Imagem fica numa faixa estável de 10 créditos. A voz é o mais barato, 1 crédito por geração.

O crédito vem de duas formas: dentro dos planos mensais (Creator, Pro e Ultimate) ou em pacotes avulsos comprados no Pix, que não expiram — você compra, usa quando quiser e o saldo fica lá. Pra automação isso conta: dá pra abastecer um lote, rodar a esteira e só reabastecer quando precisar, sem assinatura travando o ritmo.

Pra quem é essa API? Três tipos de uso

A API serve três perfis bem diferentes, e a forma de usar muda em cada um. Saber em qual você se encaixa já define se você vai escrever código, montar um fluxo ou só conversar com um agente.

O dev integrador. Quem constrói um produto, um app ou um painel e quer geração de imagem e vídeo IA por dentro, sem mandar o usuário pra outra ferramenta. Chama os endpoints direto, trata o taskId, escuta o webhook. Pra esse perfil a API é Lego: um bloco de geração que encaixa no que ele já tem.

O criador no-code. Quem não programa, mas quer escala. Aqui entra o n8n, o Make, o Zapier — você monta um fluxo que, por exemplo, lê uma planilha de prompts, dispara uma geração na Avatrix pra cada linha e salva o resultado numa pasta. É a esteira de conteúdo sem escrever código, arrastando blocos.

O operador de agente de IA. Quem usa um assistente como o Claude pra orquestrar tarefas. Com a API ligada, em vez de abrir o site e clicar, você pede em linguagem natural — "gera três variações dessa influencer numa praia" — e o agente dispara as gerações por você. É o formato que está viralizando agora em tutorial de "criei conteúdo IA em massa com Claude", e a Avatrix encaixa nele.

Dá pra usar no n8n, no Make ou no Claude?

Dá. Como a API é REST com autenticação por token, qualquer ferramenta que saiba fazer uma chamada HTTP consegue gerar pela Avatrix — e n8n, Make e Zapier sabem. Você usa o nó genérico de HTTP, cola a URL https://avatrix.io/api/v1/generate/image, põe o cabeçalho Authorization: Bearer av_SEU_TOKEN e o corpo JSON. O fluxo cuida do resto: dispara, espera, pega a resultUrl.

Pra ligar num agente de IA como o Claude, o caminho é o mesmo por baixo, só com uma camada a mais. O Model Context Protocol (MCP), o padrão aberto que a Anthropic lançou em novembro de 2024 (Anthropic, 2024), é o que deixa um assistente usar ferramentas externas dentro da conversa. Com a Avatrix por trás, "gerar uma influencer" deixa de ser clicar no site e vira um pedido em texto que o agente executa.

A peça que falta pra esse cenário ficar com um clique é a camada de MCP/skill pronta da Avatrix — e é exatamente o assunto de um próximo post aqui no blog, com o passo a passo de conectar e gerar em massa. A boa notícia: a fundação já está de pé. Token, endpoint, resposta com link — o que o agente precisa pra trabalhar já existe e está no ar.

O que a API ainda não faz?

Vale ser sincero sobre os limites — eles evitam que você bata a cabeça depois. A API é sólida no que entrega, mas tem fronteiras claras, algumas por decisão de produto, outras porque ainda estão no forno.

Primeiro, ela é de servidor pra servidor. O token av_... não foi feito pra rodar no navegador (não tem CORS aberto), porque colar um token de geração no front-end exporia seu crédito pra qualquer um. O lugar do token é no seu back-end, no n8n ou no agente — nunca no código que o usuário final enxerga.

Segundo, tem limite de ritmo: 60 requests por minuto e 20 gerações rodando ao mesmo tempo por conta. Passou disso, a API responde 429 e você espera. Pra lote grande, isso significa enfileirar com calma, não disparar tudo de uma vez. Também não dá pra cancelar uma tarefa já enviada — ela roda até terminar.

Terceiro, algumas coisas não estão expostas de propósito, e outras ainda não chegaram. Não existe endpoint de troca de rosto de pessoa real — é uma escolha consciente. E ainda não há uma rota pública que liste os modelos disponíveis nem a camada de MCP empacotada; as duas estão no radar. Pra qualquer dúvida sobre o que existe hoje, a doc em avatrix.io/api/docs é o que vale.

API ou o site: quando usar cada um?

Use o site quando o trabalho é artesanal: criar uma influencer com calma, testar prompt, escolher a melhor foto na mão. Use a API quando o trabalho é repetir — gerar dezenas de variações, alimentar um app, rodar uma esteira que trabalha enquanto você dorme. Não é um ou outro: o mesmo token e os mesmos créditos valem nos dois.

O divisor é o volume. Uma influencer, uma campanha pontual, um teste: o site resolve mais rápido, sem montar nada. Conteúdo em escala, integração num produto, automação de verdade: aí a API paga o esforço de configurar, porque ela tira você do meio do processo. A engine é a mesma — muda só quem aperta o botão, se é a sua mão ou o seu código.

Perguntas frequentes

Como gero o token da API da Avatrix?

Na sua conta, em avatrix.io/account/tokens, você cria um token escolhendo os escopos (o que ele pode fazer) e uma validade opcional. Ele começa com av_ e é mostrado uma vez só — o sistema guarda só o resumo criptografado. Se perder, você revoga e cria outro. O token vai no cabeçalho Authorization: Bearer de cada request.

A geração é instantânea?

Não — é assíncrona. O request devolve na hora um taskId com status: queued, e a geração roda em segundo plano. Você acompanha por GET /tasks/:id até ficar completed e pegar a resultUrl, ou recebe um webhook quando termina. Imagem fica pronta em segundos; vídeo leva mais, por ser mais pesado.

Qual a diferença da API da Avatrix pras gringas?

A principal é mercado: a Avatrix é brasileira, com conta, crédito e pagamento em real ou Pix e suporte em português. A maioria das APIs de vídeo IA (avatar corporativo, UGC gringo) cobra em dólar, via cartão internacional, e atende em inglês. Por baixo, a Avatrix roda modelos de mercado (Veo 3.1, Kling 3.0, Seedream 4.5, Nano Banana Pro) — a engine é forte; o diferencial é ser nacional.

Posso revender ou abrir a geração pros meus usuários?

A API foi pensada pra você usar na sua operação — esteira própria, produto seu, automação sua. Cada token tem escopo e registro de uso, o que ajuda a controlar o que roda. Antes de montar um produto que repassa geração pra terceiros, confira as regras de uso na doc oficial e fale com o suporte — é o caminho certo pra não tomar susto.

Preciso de plano pago pra usar a API?

Sim. Como toda geração gasta crédito e a Avatrix não tem plano gratuito, você precisa de saldo — seja por um plano mensal, seja por um pacote de crédito avulso no Pix. O bom é que o token não custa nada à parte: a API usa o mesmo crédito que você já usaria no site.

Comece a gerar pela API

A API REST da Avatrix está no ar, é brasileira e roda a mesma engine que mais de 5.000 criadores já usam. Você cria a conta, gera um token em segundos e dispara a primeira imagem com um curl — depois é montar a esteira que faz sentido pro seu fluxo, no código, no n8n ou no agente.

A doc completa, com cada endpoint e cada campo, está em avatrix.io/api/docs. Pra rodar agora:

Criar conta e gerar meu token da API →