Connecter son propre modèle d’IA : endpoint, clé et repli
Configure un modèle compatible OpenAI dans Mono, teste la connexion et distingue réponses textuelles et exécution d’outils.
Un endpoint personnalisé permet d’envoyer les requêtes au serveur de ton choix. Le modèle peut fonctionner sur ton ordinateur ou chez un prestataire : saisir son adresse ne le fait pas tourner sur ton téléphone. Commence par une demande courte, sans données sensibles.
Mono by Reunified te permet d’utiliser ton propre modèle, et les réponses d’un modèle que tu fais tourner toi-même ne coûtent rien dans Mono. Mono est actuellement sur liste d’attente. Ce guide montre les réglages et te donne une checklist à utiliser quand tu auras accès. Même si un serveur se dit compatible, teste-le avec ton application et ton modèle exacts.
1. Rassemble les bons paramètres
Il te faut l’URL de base de l’API, l’identifiant exact du modèle et, si nécessaire, une clé d’API. Suis les instructions de la personne ou du service qui gère le serveur. L’adresse d’un site web, une page de téléchargement de modèle ou l’URL d’un serveur MCP ne sont pas un endpoint d’API de modèle.
Mono envoie les requêtes de texte vers le chemin Chat Completions sous l’adresse que tu saisis : saisis donc la base de l’API, pas le chemin complet. Par exemple, si ton fournisseur indique https://models.example.com/v1/chat/completions, saisis https://models.example.com/v1. C’est une adresse inventée, pas un vrai service.
Vérifie ce que le modèle prend en charge d’autre. Savoir répondre en texte ne veut pas dire gérer les images, les outils, le streaming ou toutes les options de requête.
2. Configure un seul rôle
Ouvre Réglages, puis Intégrations, et active Modèle de texte dans Endpoints personnalisés. Saisis l’URL de l’endpoint, la clé d’API et l’ID du modèle dans leurs champs. Ne mets pas de clés dans des messages de chat ni dans des captures d’écran. Un serveur local sans authentification peut se passer de clé, mais cela ne le rend pas sûr à ouvrir sur Internet.
Commence par le modèle de texte. Mono a des réglages séparés pour les modèles de texte, de code et d’assistance : en changer un ne change pas les autres. Note lequel tu as modifié, pour savoir par où commencer si quelque chose casse plus tard.
Avec un modèle de texte personnalisé, certaines fonctions, comme les outils et les skills, peuvent ne pas marcher comme avec les modèles intégrés de Mono. Teste d’abord une simple conversation. Si un flux a besoin de skills, une bonne réponse en texte ne prouve pas que le flux marchera.
3. Choisis le comportement de repli
Chaque modèle personnalisé a un interrupteur « Utiliser le modèle par défaut si injoignable », activé par défaut. Ne suppose pas que toutes les fonctions réagissent de la même façon à un serveur en panne. Teste-le : arrête ton serveur et regarde ce qui se passe dans la fonction que tu utilises.
Si tes requêtes doivent aller uniquement vers ton propre serveur, pour la confidentialité ou les coûts, désactive cet interrupteur et teste ce qui se passe quand ton serveur tombe. Vérifie où partent réellement les requêtes ; un réglage à l’écran ne suffit pas. Changer le modèle de texte laisse aussi les autres modèles et les outils connectés à vérifier.
Consulte le guide de confidentialité et le guide des coûts avant d’envoyer du contenu sensible.
4. Fais un petit test
Demande : « Renvoie les trois mots rouge, vert, bleu sur des lignes séparées. » Vérifie que la réponse arrive, que les journaux de ton serveur (s’il en a) montrent le modèle choisi et que la page d’utilisation du fournisseur correspond à ton test.
Teste ensuite une fonction dont tu as vraiment besoin, comme une conversation plus longue. Change une seule chose à la fois. Note la version de l’application, celle du serveur, l’ID du modèle et la date ; un résultat pour une combinaison ne veut pas dire que tous les modèles marcheront.
Pour un serveur sur ton ordinateur, teste aussi depuis le vrai réseau de ton téléphone. Sur le téléphone, localhost désigne le téléphone lui-même. Utilise une méthode de connexion avec authentification prise en charge par ton serveur, au lieu d’ouvrir un service non protégé sur Internet.
5. Repère la première couche en échec
| Symptôme | Première vérification |
|---|---|
| Délai dépassé | Serveur lancé, appareil capable de le joindre, règles réseau |
| Accès refusé | Bonne clé, compte et conditions de connexion |
| Erreur « introuvable » | URL de base, et chemin /chat/completions ajouté deux fois |
| Modèle inconnu | ID exact du modèle disponible sur ce serveur |
| Texte fonctionnel, workflow en échec | Outils ou autres fonctions dont le workflow a besoin |
Retire les secrets de tous les journaux que tu partages. Se connecter sur le site du fournisseur ne prouve pas que ta clé d’API marche, et un test de texte réussi ne veut pas dire que le modèle de code est configuré.
6. Garde une configuration réversible
Note tes anciens réglages, sans les secrets. Après un changement de serveur, refais le petit test et vérifie les coûts dans l’application et chez le fournisseur. Vérifie les autres réglages de modèle avant de qualifier une configuration de « locale » ou de « privée ».
Rejoins la liste Mono. Pour connecter un service externe plutôt que remplacer le modèle, consulte le guide MCP.
