Agentes de IA agora podem se cadastrar no Hermoso e comprar os próprios créditos

O Hermoso sempre funcionou a partir de agentes de IA. Claude, ChatGPT, Cursor e companhia pesquisam anúncios, criam e publicam, e é isso que torna o Hermoso um agente de marketing com IA e não só mais um painel. Mas havia uma coisa que um agente não conseguia fazer sozinho: ter uma conta. Toda conta começava com uma pessoa numa tela de login. A partir desta semana, agentes podem começar pela API e pagar por conta própria quando já estiverem dentro. O cadastro por agente foi lançado em 26 de agosto, e os pagamentos por máquina, em 28 de agosto.

Cadastro por agente

Um agente começa com POST /v1/signup. Isso cria um checkout para um plano pago. O pagamento acontece na página de checkout da Stripe, feito por uma pessoa ou por um método de pagamento que o agente possa usar. Depois de pago, o agente reivindica a conta com POST /v1/signup/{id}/claim e recebe a própria chave de API. A partir daí, tem a plataforma inteira: as ferramentas MCP, a API REST e tudo mais.

O cadastro por agente passa por um plano pago de propósito. Isso mantém as contas de agentes respaldadas por um pagamento real e mantém o plano gratuito para as pessoas. O cadastro no app funciona exatamente como sempre funcionou.

Pagamentos por máquina

Ficar sem créditos costumava significar um agente enviar um link de checkout para a pessoa dele. Agora, um agente que tem a própria credencial de pagamento pode comprar um pacote de créditos diretamente:

Ele pede um pacote em POST /api/billing/machine-payment.
O Hermoso responde com HTTP 402 Payment Required e um desafio de pagamento.
O agente autoriza o pagamento e tenta de novo, e o pacote cai na conta.

Isso roda sobre os pagamentos por máquina da Stripe. Com cartões, o agente paga por uma carteira feita para agentes, gastando dentro de limites definidos por uma pessoa, e nunca guarda o número do cartão. Os pacotes são os mesmos que as pessoas compram no app, pelos mesmos preços, com os mesmos créditos. As carteiras podem descobrir o endpoint sozinhas a partir do nosso documento OpenAPI, e GET /api/billing/config lista os pacotes.

O caminho conhecido continua funcionando

A maioria dos agentes ainda não tem a própria credencial de pagamento, então o caminho habitual também está disponível. buy_credits lista os pacotes, cobra um cartão salvo em um passo quando existe um, e, caso contrário, devolve um link de checkout para uma pessoa abrir. Ative a recarga automática com set_auto_reload e um saldo baixo se recarrega sozinho.

O que um agente pode fazer no primeiro dia

Assim que um agente tem a chave, ele tem o mesmo Hermoso que uma pessoa tem no app:

Configurar a marca a partir de um site, uma descrição ou um perfil de rede social.
Pesquisar os anúncios que já estão funcionando no mercado e os criadores que as pessoas estão assistindo.
Planejar e renderizar anúncios finalizados em imagem e vídeo.
Publicar e agendar nos canais que as pessoas conectam, e ler como os posts foram.

Conectar uma conta social ou de anúncios ainda acontece na tela de login da própria plataforma, então uma pessoa clica nessa parte uma vez.

Os controles ficam com as pessoas

Recargas com um clique usam um cartão salvo e exigem direitos de administrador de faturamento. As assinaturas são gerenciadas por uma pessoa em Workspace, Billing. E um pagamento por máquina só pode comprar os pacotes de créditos que o Hermoso lista, pelos preços listados, então um agente pode continuar trabalhando sem conseguir mudar o que paga.

Por que construímos isso

Boa parte do trabalho de marketing vai ser feita por agentes que trabalham o tempo todo: pesquisa durante a noite, anúncios novos de manhã, posts saindo no horário. Esses agentes devem conseguir começar, continuar e pagar por conta própria, sem esperar alguém clicar em um botão. Agora conseguem.

Experimente

Os endpoints estão na referência da API, e conectar um agente ao Hermoso leva alguns minutos pela página do MCP.

Perguntas frequentes

Um agente de IA consegue criar uma conta no Hermoso?

Sim. POST /v1/signup cria um checkout para um plano pago. Depois do pagamento na página de checkout da Stripe, o agente reivindica a conta com POST /v1/signup/{id}/claim e recebe a própria chave de API.

Por que o cadastro por agente exige um plano pago?

Para manter as contas de agentes respaldadas por um pagamento real. O plano gratuito continua para as pessoas que se cadastram no app.

Como um agente compra créditos sem uma pessoa?

Com a própria credencial de pagamento, o agente pede um pacote em POST /api/billing/machine-payment, recebe um desafio HTTP 402, autoriza o pagamento e tenta de novo. O pacote é adicionado à conta.

Agentes pagam preços diferentes?

Não. Agentes compram os mesmos pacotes de créditos, pelos mesmos preços, que as pessoas no app.