Higgsfield do zero: plano, CLI no terminal e teto de créditos

Para que serve no AFK

• Vídeo com gente, produto e movimento de câmera pelo Estúdio IA (/estudio-ia), com os modelos que a sua conta da Higgsfield oferece.
• Como pedir: "usa a higgsfield", "faz um vídeo realista de...", "vídeo de produto realista", "cria um influencer de IA", "UGC". Com o programa da Higgsfield instalado, o Estúdio IA escolhe a Higgsfield primeiro e diz isso.
• Rosto fixo (Soul ID): um personagem treinado na sua conta da Higgsfield aparece com o mesmo rosto em todas as cenas.
• O gasto fica registrado: cada pedido vai para meu-negocio/conteudo/estudio/gastos-higgsfield.jsonl antes de ser feito. Se a resposta não chegar, o pedido fica marcado como "incerto".
• Também fica na Higgsfield: todo vídeo gerado aparece em Assets, no site da Higgsfield.

O caminho grátis que o AFK já tem

Rosto de perto, bicho e pessoa falando pedem uma rota paga: Higgsfield, fal.ai (fal.ai: vídeo por IA pago por segundo) ou Gemini (Chave do Gemini no Google AI Studio (tem camada grátis)).

Antes: grátis ou pago

• Plano anual: dá para pagar por ano. Confira o preço em higgsfield.ai/pricing.
• Planos de equipe: Team (US$ 79 por pessoa, por mês, 1.000 créditos cada) e Scale (US$ 215 por pessoa, por mês, 2.500 créditos cada).
• Créditos do plano não passam para o mês seguinte. No plano anual, eles renovam a cada 30 dias.
• Pacote de créditos e recarga automática (Auto-Refill): só com assinatura ativa, e o Auto-Refill não existe nos planos de entrada. Esses créditos vencem 90 dias depois da compra. Na recarga automática, US$ 1 compra 18 créditos. O Auto-Refill vem desligado: deixe assim.
• Pelo AFK, todo vídeo gasta créditos. As gerações grátis e os modelos "ilimitados" do plano valem só no site da Higgsfield, não pelo programa no terminal.
• A Higgsfield não tem teto de créditos para agente. Quem segura o gasto é o AFK: o teto de cada pedido e o teto do dia (Parte 4).
• O custo de cada vídeo depende do modelo e da duração. No site, ele aparece no botão Generate antes de confirmar. No AFK, aparece na estimativa.
• Preço e plano mudam. Confira em higgsfield.ai/pricing.

Uso comercial e direito de imagem

• O vídeo é seu. Os termos da Higgsfield dizem que você é dono do que gera e pode passar os direitos a um cliente. O resultado não é exclusivo: outra pessoa pode gerar algo parecido.
• A Higgsfield pode treinar os modelos dela com o seu conteúdo, fora do plano Enterprise. Não mande foto de cliente ou documento sem autorização.
• Você não pode treinar outra IA com o que a Higgsfield gera.
• Pessoa real, só com autorização. Os termos proíbem usar a imagem de outra pessoa sem permissão. O Estúdio IA usa foto de pessoa real só com a autorização escrita dela guardada na pasta do personagem. No Brasil, usar rosto ou voz de alguém em peça comercial sem autorização permite que a pessoa proíba e peça indenização (Código Civil, art. 20). Nunca imite celebridade.
• Nada de depoimento falso. Personagem de IA pode apresentar e mostrar o produto, mas não pode dizer "usei e amei" como se fosse cliente: é propaganda enganosa.
• Rótulo de IA: marque "feito com IA" ao postar. Instagram, TikTok e YouTube pedem. O AFK grava esse lembrete junto do vídeo.

Parte 1: criar a conta e assinar

O site da Higgsfield é em inglês. Os nomes dos botões abaixo estão como aparecem na tela.

1. Abra higgsfield.ai e crie a conta.
2. Proteja a conta: senha forte e única. Se entrar com Google ou Apple, ligue a verificação em duas etapas nessa conta. Quem entra na sua conta gasta os seus créditos.
3. Em higgsfield.ai/pricing, assine um plano pago. Para testar, o Starter basta.

Parte 2: instalar o programa da Higgsfield

O programa roda no terminal (o CLI oficial). Ele precisa do Node.js.

1. Abra o terminal (PowerShell no Windows).
2. Se não tem o Node.js, instale:

   winget install OpenJS.NodeJS.LTS

   Feche e abra o terminal de novo.

3. Instale o programa da Higgsfield:

   npm i -g @higgsfield/cli

Parte 3: entrar na conta

1. No terminal, rode:

   higgsfield auth login

2. O navegador abre. Entre com a sua conta da Higgsfield e aprove.
3. Pronto: não há chave para copiar. O programa guarda a sessão no seu computador. Quem usa o seu computador pode gastar os seus créditos.
4. Para ver os comandos do programa, rode higgsfield --help.

No painel do AFK, o cartão Higgsfield (rota profissional de vídeo) não tem campo nem Testar: a conexão mora no programa. Ele não muda para "conectado" depois do login. Para conferir se o AFK achou o programa, rode no terminal, dentro da pasta do AFK:

python ferramentas/ia-media/estudio.py rotas

Na resposta, o campo higgsfield deve começar com "instalada". Essa conferência não prova o login: a prova é o teste da Parte 4.

Parte 4: pôr o teto de créditos

O AFK tem dois tetos. Os dois param o pedido antes de gastar.

1. Teto de cada pedido: o AFK mostra o custo em créditos e pergunta quanto você aprova. Sem esse número, ele não gera. Se o programa da Higgsfield não informar o custo, o AFK também não gera.
2. Teto do dia (opcional): abra o arquivo .env na pasta do AFK e preencha, por exemplo:

   HIGGSFIELD_TETO_DIA=50

   O número é em créditos. O AFK soma os pedidos do dia e para quando o próximo passaria do teto.

3. Faça um teste curto: diga "faz um vídeo de 5 segundos com a Higgsfield". Aprove o custo e o teto. O vídeo vai para meu-negocio/conteudo/estudio/.

No dia a dia

Erros e soluções

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande a chave. Na Higgsfield, também nunca mande a senha nem o código de login.

Fontes oficiais (conferido em 30/10/2026): higgsfield.ai/creator-hub/help-center/integrations/how-do-i-connect-higgsfield-to-ai-agent (Claude Code usa o CLI: npm i -g @higgsfield/cli, higgsfield auth login no navegador; exige assinatura paga ativa; toda geração por agente gasta créditos; sem teto nativo de créditos) · higgsfield.ai/creator-hub/help-center/mcp-cli/how-do-i-access-higgsfield-via-cli (sem chave de API; gerações grátis e modelos ilimitados não valem pelo CLI; você responde pelo que o agente gera) · npmjs.com/package/@higgsfield/cli (pacote oficial, licença MIT, Windows x64 e arm64, higgsfield --help) · higgsfield.ai/blog/higgsfield-pricing-explained (Starter US$ 15 com 200 créditos, Plus US$ 49 com 1.000, Ultra US$ 129 com 3.000, Team US$ 79 e Scale US$ 215 por pessoa; Free sem créditos e sem uso comercial; pacote e Auto-Refill só com assinatura) · higgsfield.ai/creator-hub/help-center/credits/how-credits-work (créditos do plano não passam adiante; anual renova a cada 30 dias; custo no botão Generate; saldo na barra de cima e em Manage Account → Subscription) · higgsfield.ai/creator-hub/help-center/credits/top-up-credits-expiry-a (pacote e Auto-Refill vencem em 90 dias; pacote exige assinatura ativa) · higgsfield.ai/creator-hub/help-center/credits/how-does-auto-refill-work (Auto-Refill desligado por padrão; fora dos planos de entrada; US$ 1 = 18 créditos) · higgsfield.ai/creator-hub/help-center/account/who-owns-my-generations-and-can-i-use-them-commercially (você é dono do resultado; não exclusivo; sem treinar outra IA; imagem de outra pessoa só com permissão; a Higgsfield pode treinar com o conteúdo fora do Enterprise) · planalto.gov.br/ccivil_03/leis/2002/l10406compilada.htm (Código Civil, art. 20).