Ligar um modelo de IA próprio: endpoint, chaves e alternativa
Configure um modelo compatível com OpenAI no Mono, teste a ligação e distinga respostas de texto da execução de ferramentas.
Um endpoint próprio permite enviar pedidos para um servidor à sua escolha. O modelo pode funcionar no seu computador ou num fornecedor alojado; indicar a morada não faz com que funcione no telemóvel. Comece com um pedido curto e sem dados sensíveis.
O Mono by Reunified permite usar o seu próprio modelo, e as respostas de um modelo que corre por sua conta não custam nada no Mono. O Mono está atualmente em lista de espera. Este guia mostra as definições e dá-lhe uma lista de verificação para usar quando tiver acesso. Mesmo que um servidor diga ser compatível, teste-o com a aplicação e o modelo exatos que vai usar.
1. Reúna os dados de ligação
Precisa do URL base da API, do ID exato do modelo e, se for exigida, de uma chave de API. Siga as instruções de quem gere o servidor. O endereço de um site, uma página de transferência de modelos ou o URL de um servidor MCP não são um endpoint de API de modelos.
O Mono envia os pedidos de texto para o caminho Chat Completions abaixo do endereço que introduz, por isso introduza a base da API e não o caminho completo. Por exemplo, se o seu fornecedor indicar https://models.example.com/v1/chat/completions, introduza https://models.example.com/v1. É um endereço inventado, não um serviço real.
Verifique o que mais o modelo suporta. Responder em texto não significa que suporte imagens, ferramentas, streaming ou todas as opções de pedido.
2. Configure uma função de modelo
Abra Configurações, depois Integrações, e ative Modelo de texto em Endpoints personalizados. Introduza o URL do endpoint, a chave de API e o ID do modelo nos respetivos campos. Não coloque chaves em mensagens de conversa nem em capturas de ecrã. Um servidor local sem início de sessão pode não precisar de chave, mas isso não o torna seguro para abrir à internet.
Comece pelo modelo de texto. O Mono tem definições separadas para os modelos de texto, de código e de apoio, por isso mudar um não muda os outros. Anote qual mudou, para saber por onde começar se algo correr mal mais tarde.
Com um modelo de texto personalizado, algumas funcionalidades, como ferramentas e skills, podem não funcionar da mesma forma que com os modelos integrados do Mono. Teste primeiro uma conversa simples. Se um fluxo precisar de skills, uma boa resposta em texto não prova que o fluxo vá funcionar.
3. Decida o comportamento em caso de falha
Cada modelo personalizado tem um interruptor «Usar o modelo padrão se o endpoint não responder», ligado por predefinição. Não assuma que todas as funcionalidades reagem da mesma forma a um servidor em baixo. Teste: pare o seu servidor e veja o que acontece na funcionalidade que usa.
Se os seus pedidos tiverem de ir apenas para o seu próprio servidor, por privacidade ou custos, desligue este interruptor e teste o que acontece quando o servidor falha. Verifique para onde vão realmente os pedidos; uma definição no ecrã não chega. Mudar o modelo de texto deixa ainda por rever os outros modelos e as ferramentas ligadas.
Consulte a lista de privacidade e o guia de custos antes de enviar material sensível.
4. Faça um teste pequeno
Peça: «Devolve as três palavras vermelho, verde, azul em linhas separadas.» Verifique se a resposta chega, se os registos do servidor (se existirem) mostram o modelo escolhido e se a página de utilização do fornecedor corresponde ao teste.
Depois teste uma funcionalidade de que precise mesmo, como uma conversa mais longa. Mude uma coisa de cada vez. Anote a versão da aplicação, a versão do servidor, o ID do modelo e a data; um resultado para uma combinação não significa que todos os modelos funcionem.
Se o servidor estiver no seu computador, teste também a partir da rede real do telemóvel. No telemóvel, localhost é o próprio telemóvel. Use um método de ligação com início de sessão suportado pelo servidor, em vez de abrir à internet um serviço desprotegido.
5. Identifique a primeira camada que falha
| Sintoma | Primeira verificação |
|---|---|
| Tempo de espera excedido | Servidor ativo, o dispositivo chega até ele, regras da rede |
| Acesso não autorizado | Chave correta, conta e requisitos de início de sessão |
| Erro de «não encontrado» | URL base, e se o caminho /chat/completions foi acrescentado duas vezes |
| Modelo desconhecido | ID exato do modelo disponível nesse servidor |
| Texto funciona, fluxo não | Ferramentas ou outras funcionalidades de que o fluxo precisa |
Retire os segredos de qualquer registo que partilhe. Iniciar sessão no site do fornecedor não prova que a sua chave de API funciona, e um teste de texto bem-sucedido não significa que o modelo de código esteja configurado.
6. Mantenha a configuração reversível
Anote as definições anteriores, sem os segredos. Depois de mudar de servidor, repita o pequeno teste e verifique os custos na aplicação e no fornecedor. Reveja as outras definições de modelo antes de chamar «local» ou «privada» a uma configuração.
Adira à lista do Mono. Para ligar um serviço externo em vez de substituir o modelo, consulte o guia de MCP.
