Guia · Beta

Use sua própria chave

Rode a IA do Sonny na sua própria conta OpenAI ou Anthropic — ou em um servidor auto-hospedado compatível com OpenAI — com conversas com IA ilimitadas. Uma liberação única de $249, sem assinatura extra. Veja o que você ganha e como configurar.

Quer a apresentação completa e a comparação de custos? Veja a visão geral do Use sua própria chave.

O que a liberação oferece

Conversas com IA ilimitadas
Os limites mensais de conversas deixam de existir. Seu provedor cobra pelos tokens que o modelo escolhido usar.
Seu provedor, seu modelo
Conecte o OpenAI, o Anthropic (Claude) ou qualquer endpoint compatível com OpenAI — inclusive um servidor Ollama ou vLLM auto-hospedado. Escolha entre modelos selecionados ou informe qualquer ID de modelo.
Controle onde a IA processa os dados
Toda resposta exibida aos clientes é gerada na sua conta, sob o seu contrato com o provedor. Ideal para ambientes de servidor personalizados e exigências de residência de dados.
As chaves ficam em segredo
Sua chave de API é criptografada no armazenamento e nunca mais é exibida — só uma dica como "sk-a…4f2a" para você saber qual chave está conectada.
Todos os recursos de IA incluídos
A resposta automática, os rascunhos de IA e o aprimoramento de texto passam todos pela sua chave. O comportamento, os limites de confiança e os horários de atendimento funcionam exatamente como antes.
A base de conhecimento continua gerenciada
Suas fontes de conhecimento continuam gerenciadas pelo Sonny, sem custo extra. O provedor conectado gera as respostas exibidas aos clientes.

Como configurar

  1. 01

    Libere o Use sua própria chave

    Abra o AI Copilot e encontre o cartão Motor de IA. Em Use sua própria chave, selecione Liberar por $249. É uma compra por espaço de trabalho, e só o proprietário do espaço de trabalho pode fazê-la.

  2. 02

    Configure sua chave

    Selecione Configurar sua chave para abrir Conecte sua própria IA. Em Provedor, escolha OpenAI, Anthropic (Claude) ou OpenAI-compatible. Informe a Chave de API e escolha um Modelo. Servidores compatíveis com OpenAI também precisam da URL do endpoint pública final em HTTPS; inclua o caminho /v1 se o servidor usar um. Adicione Basic Auth ou cabeçalhos de acesso personalizados se o seu proxy exigir.

  3. 03

    Teste a conexão

    Selecione Testar conexão. Conectividade verifica se o Sonny consegue alcançar o provedor e se autenticar. Chamada de ferramentas verifica se o modelo consegue pesquisar o conhecimento e transferir para um colega. As duas precisam passar antes que a conexão possa ser ativada.

  4. 04

    Salve e ative

    Selecione Salvar e ativar. A página do AI Copilot passa a mostrar Usando sua chave. Use Gerenciar conexão para trocar o provedor, as credenciais ou o modelo depois.

Uma observação sobre custos

O custo exato depende do seu provedor, do modelo e do uso de tokens. Confira os preços atuais do seu provedor e use o painel de uso dele para acompanhar quanto suas conversas realmente custam.

Bom saber

Meu endpoint auto-hospedado precisa usar HTTPS?
Sim. O Sonny aceita apenas URLs públicas https:// para provedores auto-hospedados. Se você já conectou um endpoint http://, essa conexão foi desligada e você verá um aviso nas configurações do AI Copilot: coloque seu servidor atrás de um proxy HTTPS e informe a URL de novo para reativá-la.
Posso proteger um servidor Ollama público?
Sim. A API local do Ollama não autentica as requisições por conta própria, então coloque-a atrás de um proxy reverso HTTPS e informe no Sonny as credenciais HTTP Basic Auth desse endpoint. Você também pode adicionar até 10 cabeçalhos personalizados somente escrita para gateways como o Cloudflare Access. Quando o proxy cuida da autenticação, você pode deixar a chave de API em branco — o Basic Auth substitui a autenticação Bearer por chave de API, então uma chave fictícia nunca seria enviada. Se o seu gateway precisar das duas, configure a chave de API dele em outro cabeçalho personalizado. As credenciais e os valores dos cabeçalhos são criptografados e nunca voltam para o seu navegador.
O que acontece se minha chave parar de funcionar?
Os clientes nunca ficam sem resposta. Se o seu provedor recusar uma requisição — chave expirada, limite de uso, servidor fora do ar —, a resposta automática encaminha essas conversas para a sua equipe na hora, e os proprietários do espaço de trabalho recebem uma notificação com o erro. Corrija a chave (ou volte para o Sonny AI) e tudo volta a funcionar.
Posso voltar para o Sonny AI?
Quando quiser. O cartão tem um botão de liga/desliga — desligue e o Sonny AI assume na hora (com um plano de IA ativo). Sua chave e suas configurações ficam guardadas, para você voltar com um clique. Você pode até manter um plano de IA e o BYOK ativos ao mesmo tempo; o que estiver ativado cuida das respostas.
Quais modelos devo usar?
Use um modelo rápido e com suporte a ferramentas, como um da classe Claude Haiku ou da classe mini da OpenAI. Modelos auto-hospedados menores podem funcionar, mas espere respostas de qualidade inferior e escalonamentos menos confiáveis; o teste de chamada de ferramentas integrado avisa se um modelo não der conta do recado.
As páginas da base de conhecimento continuam tendo limite?
Sim — o BYOK inclui um limite de conhecimento de 5.000 páginas, porque o Sonny continua gerenciando suas fontes de conhecimento separadamente do uso do provedor. Se você também tiver um plano de IA com um limite maior, fica valendo o maior.
Minha chave de API está segura?
Suas credenciais são criptografadas no armazenamento, nunca mais exibidas depois de salvas e usadas só quando o Sonny envia uma requisição ao provedor configurado. As URLs de endpoints auto-hospedados ficam restritas ao endpoint HTTPS público que você configurar.

Documentos relacionados

Veja como o Sonny ajuda