Modelos de IA e chave própria

A IA no painel funciona em vários lugares: descrições de produtos e pratos, respostas ao cliente, análise de ligações, montagem de materiais didáticos, assistente por seções. Por padrão, somos nós que escolhemos o modelo para cada tarefa — e para a maioria isso é suficiente.

A seção «Modelos de IA (LLM)» é para quem precisa decidir por conta própria: qual serviço responde pelas funções de assistente da conta e em qual modelo ele opera. E se você já tem um contrato próprio com um provedor — é possível conectar uma chave própria, e as chamadas passarão por ela.

Abrir: cartão «Modelos de IA (LLM)» na loja de extensões (categoria «Conta») → admin.cenaly.com/ai-models. A seção não tem item próprio no menu — isso não é um erro, a porta é uma só, pela loja. A seção está disponível apenas para o proprietário da conta.

Para que serve esta seção#

O que é necessário para começar#

Passo 1. Conectar um serviço de IA pronto#

O primeiro bloco da página é «Serviços de IA Cenaly»: ChatGPT (OpenAI), Gemini (Google), Grok (xAI) e DeepSeek. Conexão em um clique:

1. Clique em «Conectar» no serviço desejado — não são necessárias chaves de API, a requisição passa pela nossa infraestrutura.
2. No serviço conectado aparecerá a linha «Modelo» — escolha um modelo específico na lista do serviço (a lista é própria de cada um e é atualizada de tempos em tempos).
3. Um serviço desnecessário é desconectado pelo botão «Desconectar».

O pagamento é feito com créditos de IA da conta, como em qualquer outra função de IA: não aparece uma fatura separada pela «conexão do ChatGPT», você paga pelas chamadas efetivas.

Passo 2. Conectar sua chave própria#

O segundo bloco é «LLMs personalizados». Ele é para quem tem acesso próprio ao modelo: contrato próprio com um provedor, gateway corporativo ou modelo próprio implantado com API compatível com OpenAI.

1. «Adicionar LLM personalizado» e preencha: Nome (como você vai identificá-lo), Base URL da API — o endereço junto com a versão, por exemplo https://api.example.com/v1 (apenas https), Chave de API, Modelo — o id do modelo nesse provedor.
2. Clique em «Testar conexão» — uma requisição de teste será enviada, e você verá «Conexão estabelecida» com a medição da latência ou o motivo da falha. O teste funciona tanto antes de salvar quanto depois, em um registro já salvo.
3. «Adicionar» — a conexão aparecerá na lista. Ela pode ser temporariamente desativada pelo botão de alternância ou excluída (com confirmação: junto com o registro, a chave salva também é excluída).

Como a chave é armazenada: ela fica no servidor e não retorna ao navegador — na interface, só aparece a marcação «Chave de API salva» e a máscara. É possível substituir a chave, mas lê-la pelo painel, não.

Sobre o dinheiro: pelas chamadas com sua chave, os créditos de IA não são debitados — você paga diretamente ao seu provedor. Mas se o seu endpoint não respondeu, a chamada não falha: ela segue pela fila comum da plataforma — e essa chamada já é contabilizada nos créditos. Verifique a disponibilidade do seu endpoint se você vir consumo onde não esperava.

Pode haver várias conexões (até dez) — por exemplo, modelos diferentes para experimentos diferentes; funcionam aquelas cujo botão de alternância está ativado.

Passo 3. Escolher o modelo preferencial#

O terceiro bloco é «Modelo preferencial», um seletor para toda a conta:

• «Padrão (recomendado por tarefa)» — a plataforma escolhe o modelo sozinha, separadamente para cada função. Este é o estado inicial;
• um serviço específico ou conexão personalizada — as funções de assistente os usarão em primeiro lugar.

A ordem das tentativas com uma preferência escolhida: primeiro o seu endpoint personalizado (se for ele o preferido), depois a chamada da plataforma no modelo escolhido, depois o caminho alternativo comum — para que a função não «morra» por causa de um único provedor indisponível.

⚠️ A escolha vale não em todas as funções de IA — detalhes em «Limitações».

Onde o consumo é visível#

O consumo de IA fica na página de assinatura, em dois cartões: «Créditos de LLM» — o saldo restante para tarefas de IA, e «Gastos com IA» — o consumo mensal por função, a previsão da fatura até o fim do mês e o teto mensal. Pelas linhas, dá para ver qual função específica está consumindo: descrições, ligações, tradutor, treinamento.

Não haverá linhas para chamadas com sua chave própria — tais chamadas não consomem o nosso saldo.

Limitações#

• A escolha não tem efeito no cenaly.ru. No ambiente russo, as funções de IA operam com o YandexGPT, e as configurações desta seção não são consultadas ali: a página abre e salva, mas não há quem a aplique. Isso é consequência das exigências de tratamento de dados, e não uma configuração esquecida.
• A escolha não tem efeito nas chamadas com ferramentas. Parte das funções é estruturada como "modelo + ferramentas" — o bot de IA do chat de visitantes, o copiloto do painel, o assistente de escrita de e-mails no e-mail. Elas operam com o próprio modelo, independentemente do que estiver selecionado aqui.
• A seção é apenas para o proprietário. O funcionário não a verá no menu e, por link direto, receberá uma tela de erro de carregamento com o botão "Tentar novamente", e não um educado "sem acesso" — sabemos disso, estamos corrigindo.
• A chave personalizada não tem prazo nem rotação automática. Se você trocar a chave no provedor, troque-a aqui também, caso contrário as chamadas passarão a seguir o caminho alternativo (e a consumir créditos).
• Apenas API compatível com OpenAI e apenas https. O endpoint é informado junto com a versão do caminho; protocolos arbitrários e formatos de resposta próprios não são suportados.
• Não conhecemos a lista de modelos do seu provedor — o id do modelo é digitado manualmente, a partir da documentação do provedor.
• São quatro serviços prontos. ChatGPT, Gemini, Grok, DeepSeek; o restante — por conexão personalizada.

Solução de problemas#

Uma análise geral por sintomas — solução de problemas; se nada ajudar, escreva para nós — como obter ajuda.

Perguntas frequentes#

É preciso entrar nesta seção?#

Não. Tudo funciona sem ela: a plataforma escolhe o modelo para cada tarefa por conta própria. A seção é necessária se você quiser escolher o modelo por conta própria ou conectar sua própria chave.

É preciso ter uma chave própria da OpenAI para usar a IA?#

Não. Os serviços prontos são conectados com um clique e funcionam pela nossa infraestrutura, com pagamento em créditos de IA da conta. A chave própria é uma alternativa, não uma exigência.

A chave própria sai mais barata?#

Depende do seu contrato com o provedor. Tecnicamente, é "por fora da nossa conta": nessas chamadas os créditos de IA não são debitados, e você paga diretamente ao provedor.

Quem vê minha chave de API?#

Ninguém pela interface: a chave é gravada no servidor e não retorna ao navegador — você verá apenas a indicação de que ela foi salva. A seção está disponível exclusivamente para o proprietário da conta.

É possível escolher modelos diferentes para funções diferentes?#

Não, a preferência é uma só por conta. Modelos diferentes para tarefas diferentes são justamente o modo "padrão", no qual a plataforma faz a escolha.

Por que no cenaly.ru a escolha não funciona?#

O ambiente russo opera com o YandexGPT: os dados não saem dos limites do ambiente, por isso provedores externos e endpoint próprio não se conectam ali.

O que acontece se meu endpoint ficar temporariamente indisponível?#

A função não quebra: a chamada seguirá a fila comum da plataforma — e será contabilizada em créditos de IA. Não haverá perda silenciosa da solicitação.

Quanto custa o próprio cartão "Modelos de IA"?#

Não há cobrança separada pela conexão do cartão — você paga apenas pelo uso efetivo dos modelos pela nossa infraestrutura.

Seções relacionadas#

• Assinatura — os cartões "Créditos de LLM" e "Despesas de IA": saldo, consumo por função e teto mensal
• Loja de aplicativos — a única porta para a seção "Modelos de IA"
• Base de conhecimento — escolha do provedor de IA para a montagem da base e consentimento para o tratamento
• Treinamento de funcionários — qual modelo monta os materiais de treinamento e as tarefas
• Tradutor de IA para o visitante — uma das funções que consomem o saldo de IA
• Chat com visitantes — o bot de IA que opera com o próprio modelo, independentemente desta escolha
• E-mail e respondedor automático de IA — mais uma função "modelo mais ferramentas", que passa por fora desta escolha
• Como obter ajuda — se a conexão não passar na verificação