Como gerar influencer IA por API? (passo a passo)

Dá pra gerar uma influencer IA inteira por API — sem abrir o site, sem clicar em nada. Você manda um POST pra https://avatrix.io/api/v1/generate/influencer com um token, recebe um número de protocolo e pega a persona pronta segundos depois. Por baixo roda a mesma engine que mais de 5.000 criadores já usam por dentro da plataforma, com 82% das gerações concluindo com sucesso (dado da própria Avatrix, snapshot do banco em junho de 2026). Este post é o caminho direto: o primeiro request, quanto custa em crédito e por que a porta de entrada aqui é diferente das gringas.

Como gerar influencer IA por API? (o caminho direto)

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

A diferença pro site não é a qualidade, é o controle. Na tela você cria uma persona de cada vez, na mão. Pela API você dispara dezenas, no horário que quiser, dentro do seu próprio fluxo. É o que separa "criar uma influencer" de "ter uma esteira de influencers rodando sozinha".

E não é um produto novo no escuro. São 5.674 criadores na plataforma e mais de 5.000 conteúdos gerados desde o lançamento (snapshot do banco da Avatrix em junho de 2026). A API só abre por request a mesma máquina que essa galera já roda na tela.

Quickstart: o primeiro request em 3 linhas

O caminho mais curto é gerar o token, mandar o POST e consultar o taskId — três passos, sem rodeio. O token de acesso (ou PAT) é a chave que identifica sua conta em cada chamada.

Passo 1 — gere o token. Na sua conta, em avatrix.io/account/tokens, crie um token escolhendo os escopos (por exemplo generate:image, que cobre a geração de persona). Ele começa com av_ e aparece uma vez só — copie e guarde num lugar seguro.

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

curl -X POST https://avatrix.io/api/v1/generate/influencer \
  -H "Authorization: Bearer av_SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{"model": "nano-banana-pro", "prompt": "influencer brasileira, 24 anos, cabelo castanho, selfie em casa com luz 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, vem a resultUrl com a foto da persona. Esse é o ciclo de qualquer geração na API. Pra ver cada endpoint e cada campo com calma, o guia completo da API da Avatrix abre o mapa inteiro.

Por que a resposta não vem na hora? (taskId, polling e webhook)

A geração é assíncrona: o request devolve um 202 com taskId e status: queued, não a imagem. Faz sentido — gerar persona e 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 polling é consultar GET /tasks/:id de tempos em tempos: o status caminha de pending pra processing e enfim completed, e aí vem a resultUrl. Simples de montar, bom pra começar.

O webhook é mais limpo pra volume. Você passa uma callbackUrl na hora de criar a geração, e quando a persona fica pronta a Avatrix faz um POST pro seu endereço com o link. 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.

O que mais a API gera além da influencer?

Além da persona, a API gera quase tudo que a plataforma faz: imagem avulsa, vídeo UGC, vídeo criativo, voz, e ainda edita imagem e troca personagem. Cada token carrega escopos, e o escopo libera o grupo de endpoints. Quem só vai gerar persona e foto cria um token com generate:image e pronto.

A engine por trás é a mesma do app — Veo 3.1, Kling 2.6, Seedream 4.5 e Nano Banana Pro. A lista completa, com o corpo de cada request, mora na doc oficial em avatrix.io/api/docs, que é a fonte viva, sempre à frente de qualquer post.

Quanto custa gerar uma influencer por API (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 — de um Seedance mais econômico a um Veo mais pesado, e a conta muda com isso. A imagem fica numa faixa estável de 10 créditos, e a voz é o mais barato, 1 crédito por geração.

O crédito vem de duas formas: nos planos mensais ou em packs avulsos comprados no Pix, que não expiram. Pra automação isso conta: dá pra abastecer um lote, rodar a esteira e só reabastecer quando precisar, sem assinatura travando o ritmo.

Todo concorrente tem API — a diferença é a moeda e a porta de entrada

As ferramentas gringas do mesmo nicho também têm API. O que muda mesmo é como você entra. Na maioria delas, o acesso de API vem num plano mais caro ou via contrato, sempre em dólar e com cartão internacional. A Arcads, por exemplo, só libera a API no plano Pro de preço sob consulta — os planos públicos (Starter e Creator, na faixa de US$ 110 a 220 por mês) não incluem API, e pra usar a API você precisa falar com vendas. A Higgsfield tem a Cloud API cobrada em dólar; HeyGen e Synthesia liberam a API por contrato enterprise.

Na Avatrix a porta é self-serve. Você cria a conta, gera o token na hora em avatrix.io/account/tokens e dispara o primeiro request — sem liberar plano de centenas de dólares, sem falar com vendas, sem cartão internacional. Paga no Pix, em real, e o crédito comprado avulso não expira.

Fonte: modelo de cobrança e acesso de API dos concorrentes nas páginas oficiais (arcads.ai, higgsfield.ai), consultadas em junho de 2026. Valores em dólar oscilam — trate qualquer conversão como aproximada. Pra um comparativo completo de mercado, veja Avatrix vs Higgsfield.

Como manter o mesmo rosto da influencer em toda geração?

Você mantém o mesmo rosto fixando a persona a partir de fotos de referência e reaproveitando esse mesmo rosto em cada nova chamada da API. É o ponto que separa uma influencer de verdade — a mesma pessoa em mil fotos — de uma imagem aleatória que troca de cara a cada geração.

Na prática, você cria a persona uma vez, guarda a referência e passa ela nos próximos requests. Aí o /generate/image devolve a mesma moça na cafeteria, na academia, no quarto — sempre com o rosto que você fixou. Sem isso, cada foto seria de outra pessoa, e ninguém segue uma "influencer" que muda de cara toda semana.

Esse é o pulo do gato de quem fatura sem aparecer. O passo a passo de montar a persona desde o zero, com referência e prompt, está em como criar influencer IA que fatura sem aparecer — a API só automatiza o que esse fluxo faz na mão.

Dá pra rodar a API sem programar?

Dá. Como a API é REST com token, qualquer ferramenta que saiba fazer uma chamada HTTP gera 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/influencer, 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. Um assistente que sabe chamar HTTP consegue gerar a persona dentro da conversa — em vez de abrir o site e clicar, você pede "gera três variações dessa influencer numa praia" e o agente dispara. A camada de MCP empacotada pra deixar isso a um clique está no forno, e o guia completo da API detalha os três perfis de uso.

Perguntas frequentes

Dá pra criar uma influencer IA por API?

Dá. Você manda um POST pra https://avatrix.io/api/v1/generate/influencer com um token av_ no cabeçalho, e a API devolve um taskId. A persona sai pela mesma engine que mais de 5.000 criadores já usam por dentro do site — só que disparada por código, não pela tela.

Quanto custa gerar uma influencer pela API?

Você paga em crédito, igual ao site. Medindo na prática em junho de 2026, uma imagem de persona sai por 10 créditos, a voz por 1 e o vídeo fica entre 40 e 56 por geração. O crédito vem dos planos ou de packs avulsos no Pix, que não expiram.

Preciso saber programar pra usar a API?

Pra fazer o request direto, ajuda saber o básico de HTTP. Mas dá pra usar sem código: o n8n, o Make e o Zapier têm um nó de HTTP onde você cola a URL, o token e o corpo do pedido. Você monta o fluxo arrastando blocos, sem escrever uma linha.

A API mantém o mesmo rosto da influencer em toda geração?

Mantém. Você fixa a persona a partir de fotos de referência e reaproveita esse mesmo rosto em cada nova geração. É o que separa uma influencer (a mesma pessoa em mil fotos) de uma imagem aleatória que muda de cara a cada vez.

A API da Avatrix é brasileira e paga em real?

É. Conta, token, crédito e pagamento em real ou Pix, com suporte em português. A maioria das APIs de geração de vídeo IA cobra em dólar e libera o acesso só num plano mais caro ou via contrato — você tem que falar com vendas. Aqui o token sai self-serve, na hora, sem falar com ninguém.

Gere sua primeira influencer por 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 persona 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 →