Guide d'intégration RisuAI

Vue d'ensemble

L'emplacement Custom Models de RisuAI vous permet de coller une Request URL, une clé API et un ID de modèle. Le piège est une bascule appelée Autofill Request URL : lorsqu'elle est activée, RisuAI réécrit l'URL que vous collez, ce qui casse silencieusement la connexion.

Configuration rapide

Copiez ces trois valeurs dans les champs Custom Models des Advanced Settings de RisuAI.

Request URL: https://api.unorouter.ai/v1/chat/completions
Clé API:    YOUR_API_KEY
ID du modèle:   claude-opus-4-5

Collez l'URL complète se terminant par `/v1/chat/completions`. RisuAI n'a pas de dropdown de modèles en mode Custom Models ; l'ID du modèle est un champ texte manuel.

Configuration pas à pas

1. 1
   Ouvrir Advanced Settings

   Dans RisuAI, ouvrez Settings, puis Advanced Settings.

2. 2
   Choisir un emplacement de modèle

   Cliquez sur le sélecteur de modèle Chat Bot, faites défiler jusqu'en bas de la liste des modèles et choisissez Custom Models.

3. 3
   Décocher Autofill Request URL

   Cette bascule doit être DÉSACTIVÉE avant de coller quoi que ce soit. Voir l'avertissement critique ci-dessus.

4. 4
   Coller la Request URL

   Collez l'URL complète se terminant par `/v1/chat/completions`.

5. 5
   Coller la clé API

   Collez votre clé API UnoRouter dans le champ API Key. Certaines builds de RisuAI nomment ce champ Authorization ; utilisez ce champ si le champ API Key n'apparaît pas.

6. 6
   Coller l'ID du modèle

   Tapez ou collez le nom exact du modèle depuis la page des modèles de UnoRouter.

7. 7
   Enregistrer

   Fermez le panneau de paramètres ; RisuAI écrit la configuration dans le localStorage.

8. 8
   Envoyer un message de test

   Ouvrez une conversation et envoyez un message de test pour vérifier la réponse.

Pourquoi la bascule de remplissage automatique est importante

Autofill Request URL a été ajoutée pour éviter les fautes de frappe face aux fournisseurs prédéfinis nommés. Pour Custom Models, elle devient un piège : RisuAI réécrit votre URL personnalisée vers une valeur par défaut qui ne pointe pas vers nous. Si une mise à jour de RisuAI réactive cette bascule, refaites l'étape 3 avant de déboguer quoi que ce soit d'autre.

Configurer le modèle auxiliaire

RisuAI utilise un second emplacement de modèle pour les tâches de traduction, de résumé et de devinette de noms. Répétez les étapes 2 à 7 pour le sélecteur Auxiliary Model, en utilisant les mêmes URL et clé UnoRouter.

Dépannage

• Erreur 404 ou « Invalid URL ». Autofill Request URL était activé lorsque vous avez collé ; RisuAI a réécrit l'URL. Décochez la bascule et recollez la Request URL.
• Cela fonctionnait avant, plus aucune réponse maintenant. Une mise à jour de RisuAI peut réactiver Autofill Request URL silencieusement. Ouvrez Custom Models et confirmez qu'il est toujours désactivé.
• Erreur 401 Unauthorized. Les builds de RisuAI exposent parfois à la fois les champs API Key et Authorization ; un seul est lu selon la version. Déplacez votre clé dans l'autre champ et réessayez.
• Modèle introuvable. L'ID du modèle doit correspondre exactement à un nom de modèle. Copiez-collez depuis la page des modèles de UnoRouter ; ne le retapez pas.
• La fonctionnalité de traduction ou de résumé est cassée. Le modèle auxiliaire n'est pas configuré. Répétez la configuration pour l'emplacement Auxiliary Model.
• La sortie en streaming est découpée ou incomplète. Le parseur SSE de RisuAI attend des événements `data:` simples. Un proxy d'entreprise qui retire le préfixe produira un streaming illisible. Testez sur un réseau non professionnel si possible.
• Les paramètres sont réinitialisés après redémarrage du navigateur. RisuAI stocke la configuration dans le localStorage du navigateur, que certains modes de confidentialité effacent. Exportez votre configuration dans un fichier depuis Settings pour la sauvegarder.