BYOK — usando sua própria chave de IA | Central de Ajuda

BYOK significa Bring Your Own Key (traga sua própria chave). Em vez de usar nossa cota de tokens padrão, você pluga sua própria conta OpenRouter e passa a pagar direto para o provedor. Três vantagens:

Economia — em volumes altos (acima de 50 mil mensagens por mês), sai mais barato do que nossos planos.
Todos os modelos — libera modelos que não estão no nosso seletor oficial (ex: DeepSeek, modelos custom, fine-tunes).
Billing separado — o custo de IA não entra na sua fatura da ControlHub.

Quando BYOK faz sentido

Seu volume	Recomendado
Menos de 10 mil mensagens por mês	Plano Starter ou Pro (mais barato e sem dor de cabeça).
Entre 10 e 50 mil mensagens por mês	Tanto faz — depende do modelo usado.
Mais de 50 mil mensagens por mês	BYOK quase sempre compensa.
Precisa de modelo específico fora do catálogo	BYOK.

Passo 1: criar conta no OpenRouter

Vá em openrouter.ai.
Crie a conta (aceita Google).
Credits → Add credits — adicione pelo menos US$ 10 para começar.
Keys → Create key — dê um nome como "controlhub-prod" e copie a chave gerada.

Passo 2: colar a chave na ControlHub

Dashboard → Conta → Integrações → OpenRouter BYOK. Cole a chave no campo e clique Salvar.

A partir desse momento, toda chamada de LLM dos seus agentes passa pela sua conta OpenRouter. Nossa cota de tokens interna continua valendo como limite de sanidade (para evitar runaway), mas o custo real sai da sua conta.

Como ver o consumo

Dois lugares:

Dashboard da ControlHub → Analytics — mostra quantos tokens seus agentes gastaram.
OpenRouter → Activity — mostra o custo em dólar da sua conta.

Segurança da chave

A chave fica criptografada no nosso banco (AES-256-GCM com chave master separada). Se suspeitar de qualquer vazamento, gere uma nova no OpenRouter e substitua em Conta → Integrações.

Removendo o BYOK

Clique em Remover na aba de Integrações. Os agentes voltam a usar nossa cota padrão imediatamente.