[ajuda] conexões

OpenRouter do zero: conta, crédito, chave com teto e privacidade

O OpenRouter é uma conta só para usar centenas de modelos de IA de vários fornecedores. Crie a conta em openrouter.ai, ponha crédito pré-pago e crie uma chave com teto de gasto em openrouter.ai/keys. A chave começa com sk-or-. Há modelos grátis (o nome termina em :free), mas com limite de 50 pedidos por dia, e parte deles roda em fornecedores que podem treinar com o que você manda: não use esses modelos na conversa com cliente. Cole a chave na Central de Conexões, no cartão OpenRouter.

Isso faz parte do AFK, o Claude que você assina já configurado no seu computador. Conhecer o AFK

Para que serve no AFK

Atendente com IA no WhatsApp, no Direct do Instagram e no Telegram, com o modelo que você escolher no catálogo do OpenRouter.
IA reserva do atendente: quando a IA principal não responde a tempo, passa do limite (429) ou o servidor dela cai (5xx), a conversa vai para o OpenRouter. Chave recusada e falta de crédito não acionam a reserva: isso é conserto, e o AFK mostra o erro.
Posts, pautas e roteiros quando o Claude Code não responde: se o OpenRouter for a IA escolhida no atendente, os scripts de texto do AFK usam a mesma IA.

O OpenRouter não ouve o áudio que o cliente manda. Para isso, o atendente usa a Groq ou a OpenAI (veja Chave da Groq (rápida e grátis para começar)).

Sem essa chave, o Claude Code já cobre o texto, e o Ollama roda modelos no seu PC.

Antes: grátis ou pago

	Modelos grátis (`:free`)	Modelos pagos (com crédito)
Preço	US$ 0	Preço de cada modelo, por milhão de tokens, sem acréscimo sobre o preço do fornecedor. Na compra de crédito, o OpenRouter cobra uma taxa de 5,5%.
Limite	20 pedidos por minuto e 50 por dia. Sobe para 1.000 por dia depois que a conta compra pelo menos US$ 10 de crédito. Pedido que falha também conta.	O limite é o de cada fornecedor.
Seus dados	Parte dos fornecedores grátis pode treinar com o que você manda.	Você bloqueia os fornecedores que treinam (Parte 3).
Para quem	Testar o AFK e textos sem dado de cliente.	Atendente de verdade.

Cada resposta do atendente é um pedido. Com 50 pedidos por dia, o atendente para no meio da tarde de um dia movimentado.
Saldo negativo bloqueia até os modelos grátis, até você pôr crédito.
O crédito pode vencer 1 ano depois da compra. O reembolso só vale nas primeiras 24 horas, e a taxa não volta.
Preço e limite podem mudar. Confira em openrouter.ai/pricing e em openrouter.ai/models.

Parte 1: criar a conta

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

Abra openrouter.ai e crie a conta.
Proteja a conta. Não achamos na documentação do OpenRouter um passo de verificação em duas etapas. Por isso, prefira entrar com uma conta Google ou GitHub que já tenha a verificação em duas etapas ligada. Quem tem a sua conta gasta o seu crédito.

Parte 2: pôr crédito

Abra openrouter.ai/settings/credits e compre crédito. Aceita cartão de crédito, AliPay e cripto (USDC).
- Comece com US$ 10. Esse valor já libera 1.000 pedidos grátis por dia e cobre os testes.
- A recarga automática (auto top-up) é opcional. Deixe desligada: assim o gasto para no saldo.
O saldo pode levar até uma hora para aparecer.

Parte 3: proteger os dados dos seus clientes

Conversa de cliente é dado pessoal. Configure isto antes de ligar o atendente.

Abra openrouter.ai/settings/privacy.
Lá você escolhe se o OpenRouter pode mandar seus pedidos para fornecedores que treinam com os dados. A configuração é separada para modelos pagos e modelos grátis.
- Modelos pagos: não permita o treino. O OpenRouter passa a usar só fornecedores que não treinam.
- Modelos grátis: se não permitir o treino, alguns modelos grátis deixam de responder. Isso é esperado.
Deixe desligado OpenRouter Use of Inputs/Outputs. Ele dá 1% de desconto em troca de o OpenRouter usar seus dados. Por padrão, o OpenRouter não guarda o texto dos pedidos.

Parte 4: criar a chave com teto

Abra openrouter.ai/keys e clique em Create API Key.
Preencha:
- Name: afk.
- Key limit: em Credit limit, ponha o máximo que essa chave pode gastar, por exemplo US$ 10. Escolha que o limite renove todo mês. Sem renovação, o limite vale para a vida toda da chave.
- Validade: se a tela oferecer data de validade, escolha até 1 ano e anote a data. Quando a chave vence, o atendente para até você colar uma nova.
Crie a chave e copie agora. Ela começa com sk-or-.
No painel do AFK, abra Conexões, clique no cartão OpenRouter, cole em Chave do OpenRouter, clique em Salvar conexão e depois em Testar.

Pôr um teto de gasto

O teto que para de verdade: o Credit limit da chave. Bateu, a chave para de responder até o limite renovar ou você aumentar.
O jeito mais simples: deixe a recarga automática desligada. O gasto fica no tamanho do crédito que você comprou.
No AFK: o teto do mês fica em Conexões → IA_TETO_MES. O AFK avisa em 80% e para o atendente em 100%. Para modelos do OpenRouter, o AFK não tem a tabela de preço: ele estima com US$ 3 por milhão de tokens de entrada e US$ 15 por milhão de saída. Se o modelo for mais caro que isso, ponha um teto menor. O teto do AFK é estimativa: o Credit limit da chave continua valendo.

No dia a dia

Você quer	Como
O atendente responder pelo OpenRouter	No painel, abra Respostas automáticas → Atendente IA. Em Qual IA, escolha OpenRouter. Em Modelo da IA, digite o nome exato do modelo, copiado de openrouter.ai/models (formato `fornecedor/modelo`). Clique em Salvar e depois em Publicar no robô 24h.
Testar antes de ligar	Na mesma tela, use Converse com ele antes de ligar. Nada vai para cliente.
Usar o OpenRouter como IA reserva	Em Conexões, no grupo Atendente de WhatsApp — qual IA responde, preencha `IA_RESERVA_PROVEDOR` com `openrouter` e `IA_RESERVA_MODELO` com o nome exato do modelo. A reserva precisa ser outro provedor, diferente da IA principal. Depois, clique em Publicar no robô 24h de novo.
Ver o saldo	openrouter.ai/settings/credits.
Achar chave sem teto	openrouter.ai/settings/security: a aba Overview mostra as chaves com No spend limit.
Trocar a chave	Crie outra, cole por cima no cartão OpenRouter e desative a antiga na página de chaves.

Erros e soluções

O que aparece	O que fazer
`402` ou `Insufficient credits`	Falta saldo, ou o saldo ficou negativo (aí até modelo grátis para). Compre crédito em openrouter.ai/settings/credits. A IA reserva não entra nesse caso.
`402` ou `403` com `Key limit exceeded`	A chave bateu o Credit limit. Aumente o limite na página da chave ou espere renovar.
`401` ou `Invalid credentials`	A chave foi apagada, desativada, venceu ou foi copiada pela metade. Crie outra e cole por cima.
`429` ou `Rate limit exceeded`	No modelo grátis: passou de 20 pedidos por minuto ou de 50 por dia (1.000 com US$ 10 comprados). O dia renova à meia-noite UTC (21h em Brasília). Para não parar, use um modelo pago. No modelo pago, se você ligou uma IA reserva, ela responde no lugar.
`404` com `No endpoints found`	O nome do modelo está errado, o modelo saiu do catálogo, ou a sua configuração de privacidade bloqueou todos os fornecedores dele. Confira o nome em openrouter.ai/models ou escolha outro modelo.
`502` ou `503`	O fornecedor do modelo caiu ou não há fornecedor disponível. Espere alguns minutos. Com IA reserva ligada, ela responde no lugar.
O cliente recebeu "Tive um problema técnico agora"	A IA falhou e o AFK passou a conversa para você. Em Respostas automáticas, no quadro Últimas respostas, a etiqueta "passou pra você" mostra o erro. Procure o código nesta tabela.

Se nada funcionar

Veja Travou ou quero sugerir uma melhoria: o que mandar. Mande o texto do erro. Nunca mande a chave.

Fontes oficiais (conferido em 30/10/2026): openrouter.ai/pricing (taxa de 5,5% na compra de crédito; modelos grátis com 20 por minuto e 50 por dia, 1.000 por dia depois de US$ 10 comprados; pedido que falha conta; saldo negativo bloqueia modelo grátis) · openrouter.ai/docs/faq (crédito pré-pago; cartão, AliPay e USDC; crédito pode vencer em 1 ano; reembolso em 24 horas sem a taxa; saldo leva até uma hora; o texto do pedido não é guardado por padrão; 1% de desconto para liberar o uso dos dados) · openrouter.ai/docs/api-reference/limits (limites dos modelos grátis; 402 por saldo ou por limite da chave) · openrouter.ai/docs/api-reference/authentication (chave em openrouter.ai/keys, com nome e limite de crédito; pôr limite em toda chave) · openrouter.ai/docs/guides/best-practices/capping-shared-agent-keys (Create API Key, Key limit, Credit limit, renovação por dia, semana ou mês à meia-noite UTC; 403 com Key limit exceeded) · openrouter.ai/docs/guides/overview/auth/security-settings (página de segurança com chaves sem teto e sem validade) · openrouter.ai/docs/guides/privacy/provider-logging (configuração separada de treino para modelos pagos e grátis) · openrouter.ai/docs/guides/privacy/data-collection (OpenRouter Use of Inputs/Outputs, desligado por padrão) · openrouter.ai/docs/guides/routing/model-variants/free (variante :free) · openrouter.ai/docs/api-reference/errors (401, 402, 403, 429, 502, 503).

ainda não tem o AFK?

Com a chave do OpenRouter, o atendente do AFK responde com o modelo de IA que você escolher, e ela também pode ser a IA reserva quando a principal cai.

O AFK deixa o Claude que você assina configurado e atualizado no seu computador: painel do negócio, conteúdo, documentos, travas e antivírus prontos. Você fala, o sistema opera. 7 dias de garantia.

Conhecer o AFK

Chaves e conexões

Não resolveu?

Escreva para contato@afk.ia.br com o passo em que você estava, o que apareceu na tela e um print. A lista do que mandar está em travou ou quer sugerir algo.