Como gerar sua chave da OpenRouter
A instância que você contratou é o corpo do agente: servidor, memória, endereço e disco. O cérebro é o modelo de linguagem, e ele é pago por uso direto ao provedor. Esta é a única configuração obrigatória depois da compra — e é a última coisa que separa você de um agente funcionando.
Pré-pago, sem fatura surpresa
Você deposita o valor que quiser. Quando o crédito acaba, o agente pausa — nunca vira dívida.
Uma chave, vários modelos
Claude, GPT e dezenas de outros com o mesmo cadastro. Trocar de modelo não exige conta nova.
A chave é sua
Fica cifrada, injetada só no seu container, e você revoga na OpenRouter quando quiser.
O passo a passo
- 1
Crie sua conta na OpenRouter
Dá para entrar com Google ou GitHub, sem cadastro longo e sem cartão nesse primeiro momento.
Abrir a OpenRouter - 2
Coloque um crédito inicial
A OpenRouter é pré-paga: você deposita um valor e o consumo sai dele. Comece com pouco, US$ 5 ou US$ 10 já dão para semanas de uso normal.
Como é pré-pago, não existe fatura surpresa: quando o crédito acaba, o agente para de responder até você recarregar. Nunca vira dívida.
Adicionar crédito - 3
Gere a API key
Em "Keys", clique em criar uma nova chave e dê um nome que você reconheça depois, como "hermes". Copie o valor na hora — ele começa com sk-or-v1- e não é exibido de novo.
Se você perder a chave, não tem problema: basta apagar a antiga e gerar outra. Nada da sua instância se perde.
Gerar minha chave - 4
Cole a chave no seu painel
No painel do HAAS, abra sua instância, escolha OpenRouter em "Chave de modelo" e cole o valor. Salvar já reconfigura o container.
A chave é guardada cifrada e nunca aparece de volta na tela. Para trocar, basta enviar outra por cima.
- 5
Escolha o modelo no dashboard
Abra o dashboard do seu agente e selecione o modelo. Recomendamos os aliases "latest", que apontam sempre para a versão mais nova sem você precisar mexer de novo.
Ver catálogo de modelos
Qual modelo escolher
O Hermes usa ferramentas a cada passo — lê arquivos, roda comandos, navega. Modelos muito baratos economizam centavos e erram a mão nessas sequências, o que sai mais caro em retrabalho. Comece por um destes:
~anthropic/claude-sonnet-latestClaude Sonnet (recomendado)O melhor equilíbrio entre qualidade e preço para uso de ferramentas, que é o que o Hermes faz o tempo todo.
~openai/gpt-latestGPT (alternativa)Boa opção se você já está acostumado com o comportamento dos modelos da OpenAI.
Os dois começam com ~ porque são aliases: apontam sempre para a versão mais recente daquele modelo. Você configura uma vez e não precisa voltar a cada lançamento.
Perguntas frequentes
Por que vocês não incluem a chave no plano?
Porque o gasto com modelo varia demais de um cliente para outro — de centavos a centenas de reais por mês, dependendo do quanto o agente é usado. Embutir isso na mensalidade significaria cobrar de quem usa pouco para bancar quem usa muito. Com a chave no seu nome, você vê exatamente o que gastou, escolhe o modelo e troca de provedor quando quiser.
Quanto vou gastar por mês?
Depende do modelo escolhido e de quanto você usa o agente. Como o crédito é pré-pago, a forma honesta de descobrir é começar com US$ 5 e observar o consumo no painel da OpenRouter na primeira semana. A partir daí você já sabe seu ritmo e recarrega no valor que fizer sentido.
Preciso da OpenRouter ou posso usar a Anthropic direto?
Pode usar a Anthropic direto, e o painel aceita as duas. Sugerimos a OpenRouter porque uma única chave dá acesso a modelos de vários fabricantes, o que deixa você trocar de modelo sem criar conta nova nem cadastrar outro cartão.
O agente parou de responder. É a chave?
Na maioria das vezes, sim, e por um dos dois motivos: o crédito acabou ou a chave foi apagada na OpenRouter. Confira o saldo primeiro; se estiver positivo, gere uma chave nova e cole no painel. Se continuar, use o botão de reiniciar na instância antes de abrir suporte.
Vocês têm acesso à minha chave?
A chave é gravada cifrada e injetada apenas no seu container, como variável de ambiente. Ela não aparece no painel depois de salva, é redigida dos nossos logs de operação e não é usada para mais nada. Você pode revogá-la na OpenRouter a qualquer momento, sem passar por nós.
Chave em mãos?
Cole no painel e a instância se reconfigura sozinha em poucos segundos. Não precisa reiniciar nada.
Cadastrar minha chave