Connexion d’un fournisseur d’IA
Préréglages, clés, test de connexion et lecture des erreurs.
NovelKnow n’est lié à aucun fournisseur de modèles — vous apportez votre propre clé API, et c’est vous qui décidez du modèle utilisé et de son coût.
La voie rapide
Paramètres IA → cliquez sur un préréglage de fournisseur → collez votre clé → testez la connexion → enregistrez.
Le préréglage renseigne l’URL de base, le modèle par défaut et la fenêtre de contexte. Ce sont les trois éléments sur lesquels on se trompe le plus souvent, et la raison habituelle pour laquelle une configuration ne fonctionne pas.
Préréglages intégrés : DeepSeek, OpenRouter, OpenAI, Kimi / Moonshot, Qwen / DashScope, SiliconFlow et Ollama local.
Tout endpoint compatible OpenAI fonctionne — choisissez l’option personnalisée et saisissez vous-même l’URL de base.
Listes de modèles
Après l’enregistrement, « 同步模型 » récupère la liste réelle des modèles auprès du fournisseur. Dès lors, les menus déroulants de modèles sont alimentés à partir de cette liste, vous n’avez donc jamais à saisir un nom de modèle à la main.
Marquez comme favoris ceux que vous utilisez souvent : ils apparaîtront en tête de liste.
Interpréter les erreurs
Les tests de connexion et les échecs de génération incluent la réponse du fournisseur lui-même, ce qui vous permet de distinguer les cas suivants :
| L’erreur contient | Signification habituelle |
|---|---|
401 / Incorrect API key | Clé incorrecte ou expirée |
404 / model does not exist | Nom de modèle incorrect, ou votre compte n’y a pas accès |
429 | Limite de débit atteinte, ou le compte n’a plus de crédit |
fetch failed / ECONNREFUSED | Le serveur n’arrive pas à joindre le fournisseur — voir la note sur le proxy ci-dessous |
Proxy sortant
Si votre déploiement n’arrive pas à joindre un fournisseur, activez le proxy sortant dans la boîte de dialogue des paramètres IA.
Cette adresse est résolue depuis le serveur de déploiement, et non depuis votre propre ordinateur. La pointer vers 127.0.0.1:7890 n’a de sens que si un proxy tourne sur le serveur lui-même.
Comment votre clé est stockée
Les clés sont chiffrées avec une clé dérivée de votre compte et ne sont renvoyées au navigateur que masquées. Vous ne reverrez plus jamais votre propre clé en entier — pour la changer, collez-en une nouvelle.