O Higgsfield tem API? Sim — e um MCP. Veja o que cada um cobra
O Higgsfield oferece duas formas de gerar fora do site: uma API paga por geração, para código, e um servidor MCP ao qual agentes de IA como o Claude se conectam com a sua conta. Eles não cobram a mesma coisa, não oferecem os mesmos modelos, e nenhum dos dois oferece uma tela para rodar duzentos trabalhos. Esta página separa uma coisa da outra e depois mostra como a Onyx.AI roda os dois em lote — sua chave, sua conta, sem código, nada acrescentado ao preço.
API, MCP e site do Higgsfield: o que cada um cobra
| Site | API | MCP | |
|---|---|---|---|
| Onde | higgsfield.ai | open.higgsfield.ai | mcp.higgsfield.ai |
| Cobrado em | Os créditos do seu plano | Um saldo de API separado, por geração | Os créditos do seu plano |
| Você precisa de | Uma conta | Uma chave de API (ID da chave + segredo) | Um plano pago ativo, sem chave |
| Unlimited | Sim, nos planos que o incluem | Não | Não, exceto em ofertas de teste por tempo limitado |
| Feito para | Uma geração por vez, manualmente | Seu próprio código ou uma ferramenta construída sobre ele | Claude, ChatGPT, Cursor e outros agentes |
Baseado na página de API e na central de ajuda do próprio Higgsfield, outubro de 2026. Preços e ofertas mudam: confira lá antes de se comprometer.
Resumindo: a API serve para pagar por geração sem assinatura; o MCP serve para gastar, a partir de um agente, os créditos de um plano que você já paga. O Unlimited continua sendo um recurso do site.
Preços da API do Higgsfield, em palavras simples
A API é paga conforme o uso. Cada modelo tem o seu preço por geração, listado no catálogo do Higgsfield, descontos por volume são aplicados automaticamente, e os seus espaços pessoal e de equipe compartilham um único saldo, com recarga automática opcional. Não é a sua assinatura: um plano do Higgsfield não recarrega o saldo da API, e o saldo da API não aparece como créditos do plano.
Qual sai mais barato depende de como você trabalha. Um volume diário constante dos modelos que o seu plano cobre costuma favorecer o plano. Lotes irregulares, ou modelos de que você só precisa de vez em quando, costumam favorecer o pagamento por geração. A resposta honesta é rodar os mesmos vinte trabalhos dos dois jeitos e olhar o que saiu da sua conta.
Como conectar o Higgsfield ao Claude
O Claude conversa com o Higgsfield pelo MCP. Os passos do próprio Higgsfield:
- Abra as configurações do Claude. No claude.ai ou no Claude Desktop, vá em Configurações, depois Conectores, e clique em Adicionar conector personalizado.
- Adicione o servidor. Dê o nome Higgsfield e informe
https://mcp.higgsfield.ai/mcp. - Faça login. Clique em Conectar, entre no Higgsfield e autorize. O conector passa a aparecer na sua lista de ativos.
Duas coisas para saber antes de pedir um lote ao Claude. Cada geração por um agente conectado desconta créditos, seja qual for o seu plano, e o Higgsfield não define nenhum limite rígido de créditos no conector — um limite que você escreve na conversa é apenas uma instrução. E o Claude trabalha uma conversa por vez: serve para algumas imagens, mas é lento e difícil de acompanhar com duzentos clipes e as mesmas configurações.
A Onyx.AI se conecta a esse mesmo MCP, com o mesmo login do Higgsfield, mas coloca uma fila atrás dele em vez de um chat.
Sua chave de API do Higgsfield: onde pegar e como ela é usada aqui
Crie uma chave em open.higgsfield.ai: você recebe um ID de chave e um segredo. Na Onyx.AI, cole os dois uma vez em Configurações, Chaves de API, no formato id:secret. A chave é validada junto ao Higgsfield antes de ser salva.
O Higgsfield não permite que a API seja chamada a partir de um navegador, então as chamadas passam pelo servidor da Onyx.AI com a sua chave. A chave fica guardada no servidor, legível apenas pelo app, nunca é gravada nos logs e nunca é devolvida à página — você só vê os últimos quatro caracteres. Remova-a com um clique e ela é apagada.
Cada chave começa com 20 trabalhos simultâneos do lado do Higgsfield. Aqui, os disparos são cadenciados para ficar dentro desse limite, então um lote grande espera uma vaga livre em vez de falhar.
O que roda em cada um
Com a sua chave de API
- Kling 3.0 e 2.6, Motion Control incluído
- Wan 3.0, Seedance 2.0 e 2.5, Grok Video, HappyHorse
- GPT Image 2.0 e 2.5, Grok Image 2.0
- Cobrado pelo Higgsfield no seu saldo de API
Com a sua conta do Higgsfield (MCP)
- Os modelos que o seu próprio plano oferece, lidos da sua conta
- Nano Banana Pro, 2 e 2.1, Seedream 5 Pro e o resto
- Upscale Topaz com os créditos do seu plano
- Cobrado nos créditos do seu plano
A conexão com a conta usa o login oficial do Higgsfield, o mesmo que o Claude usa. Ela é guardada criptografada, só para você, e o site só pode usar nela as ferramentas de geração, upload, trabalhos, modelos e saldo — nunca publicação, sites ou configurações do espaço de trabalho. Também existe uma opção Unlimited: ele só é usado quando a sua conta aceita, e se o Higgsfield recusar, você vê o motivo e o lote segue com créditos.
Lotes, dentro das ferramentas que você já usa
- Mass Motion Control. Uma imagem do seu personagem, centenas de clipes de origem, Wan 3.0 References no Higgsfield.
- Face Swap e Carousel. Um rosto, uma pasta inteira de imagens, no Nano Banana Pro.
- Image & Video. Até quatro referências e geração em lote em todos os modelos que a sua chave ou o seu plano abrem — Kling 3.0 e 2.6 Motion Control incluídos.
- Configurações lidas no clique. O prompt, as imagens e as opções são lidos no momento em que você clica em Iniciar, então uma mudança de última hora vale para o lote inteiro.
E quando o mesmo modelo custa menos em outro lugar, o provedor é um menu: mude o lote para Kie.ai, WaveSpeed ou Atlas Cloud com a sua própria chave lá. Mais sobre isso na página Alternativa ao Higgsfield.
O que faz — e o que não faz
O que faz
- Usa a API do Higgsfield com a sua própria chave, sem código
- Usa o seu plano do Higgsfield pelo MCP oficial
- Roda lotes de centenas, cadenciados conforme os seus limites
- Deixa você mudar o mesmo trabalho para outro provedor
O que não faz
- Revender o Higgsfield, seus créditos ou seu saldo de API
- Liberar modelos ou Unlimited que o seu plano não inclui
- Acrescentar margem ao preço de qualquer provedor
- Falar pelo Higgsfield — a Onyx.AI é uma plataforma independente
Perguntas frequentes
O Higgsfield tem API? Sim: uma API paga por geração, com chaves em open.higgsfield.ai, e um servidor MCP em mcp.higgsfield.ai para agentes de IA.
A API usa os créditos da minha assinatura? Não. Ela tem o próprio saldo. Os créditos do plano são gastos no site e pelo MCP.
A API do Higgsfield é grátis? Não. Cada geração é paga ao preço listado do modelo; a página da API do Higgsfield menciona um playground grátis para experimentar os modelos.
O Unlimited funciona pela API ou pelo MCP? A central de ajuda do Higgsfield diz que o Unlimited vale para higgsfield.ai, exceto em ofertas de teste por tempo limitado.
Posso usar sem código? Sim — cole a sua chave em Configurações e as ferramentas de lote chamam a API por você.
A Onyx.AI é afiliada ao Higgsfield? Não. Ela se conecta com a sua própria chave ou a sua própria conta, como qualquer cliente.
Mais respostas no FAQ — cobrança, cancelamento, privacidade e o que acontece com os seus arquivos.
Conecte a sua chave e rode um lote de verdade
Todo pack libera a plataforma inteira de graça no início — 15 dias, 1 mês ou 2 meses, conforme o pack. Tempo suficiente para rodar o mesmo lote com a sua chave de API, com o seu plano e em outro provedor, e ficar com o mais barato.