BYOK — chave global

BYOK significa Bring Your Own Key — voce traz sua propria chave de API do provedor de IA. O UltronChat nao revende creditos de IA: todo consumo acontece diretamente na sua conta do OpenAI ou Anthropic, e voce paga por uso.

Por que BYOK?

• Transparencia de custo — voce ve exatamente quanto gastou direto no dashboard do provider.
• Limites sob seu controle — voce define limites de gasto mensal na conta do provider, nao no UltronChat.
• Modelos flexiveis — use qualquer modelo que sua conta do provider tiver acesso.

Chave global vs chave especifica

• Chave global — uma chave por provider (OpenAI / Anthropic) que serve para todos os agentes do usuario que nao tenham chave propria. E o modo mais simples.
• Chave especifica por agente — chave dedicada a um agente so, para segmentar custos. Veja BYOK por agente.

Nesta pagina focamos na chave global.

Onde obter uma chave

OpenAI

1. Acesse platform.openai.com/api-keys.
2. Clique em Create new secret key.
3. De um nome (ex.: "UltronChat") e copie a chave que comeca com sk-....
4. Guarde a chave em local seguro — ela so aparece uma vez.

Anthropic

1. Acesse console.anthropic.com/settings/keys.
2. Clique em Create Key.
3. De um nome e copie a chave que comeca com sk-ant-....

Em ambos os casos, adicione credito / metodo de pagamento na conta antes de usar.

Cadastrar no UltronChat

1. No sidebar, clique em Chaves de IA (vai para /dashboard/settings/api-keys).
2. Na secao do provider desejado (OpenAI ou Anthropic), cole a chave.
3. Clique em Salvar.

O UltronChat faz um probe antes de persistir: chama a API do provider com a chave (por exemplo GET /v1/models no OpenAI) e so grava se a chave for valida. Se for invalida, voce ve erro inline e a chave nao e salva.

Screenshot: /dashboard/settings/api-keys com chave OpenAI cadastrada, mostrando fingerprint.

O que fica guardado

• Apenas a chave criptografada (AES-256-GCM) no banco.
• Um fingerprint de 4 caracteres finais (ex.: sk-...a3f2) para voce identificar visualmente qual chave esta ativa.
• Metadados: data de criacao, ultima validacao, ultimo erro (se houver), contador de uso.

Testar a chave

Depois de salva, voce pode clicar em Testar ao lado da chave. O UltronChat faz uma chamada leve no provider e atualiza last_validated_at / last_error. Util se voce suspeitar que o saldo acabou ou a chave foi revogada.

Remover a chave

Clique em Remover ao lado. O UltronChat apaga a chave criptografada e, como efeito colateral, pausa todos os agentes ativos que dependiam dela (ou seja, agentes sem chave especifica configurada). Um trigger de banco (trg_pause_agents_on_key_delete) garante isso.

Para reativar os agentes, cadastre uma nova chave e ative manualmente.

Multiplas chaves do mesmo provider?

Nao no modo global — voce tem uma chave global por provider. Se quer chaves separadas, use o modo chave especifica por agente.

Custo estimado

Atendimento por DM consome relativamente pouco. Estimativas para atendimento de pequeno porte (modelos economicos):

Volume mensal	Modelo	Estimativa de custo
100 conversas, 8 msgs cada	gpt-4o-mini	~US$ 2-5
500 conversas, 8 msgs cada	gpt-4o-mini	~US$ 10-25
1000 conversas com vision	gpt-4o	~US$ 50-100

Use o dashboard do provider para acompanhar consumo real.

Proximo passo

• Chave especifica por agente — se quer segmentar custo.
• Ativar e pausar o agente — com a chave salva, ative o agente.