Documentation BibGenieModèles personnalisés
Ajoutez et gérez des modèles personnalisés, notamment OpenAI, Anthropic, OpenRouter, Ollama, LM Studio et les API compatibles.
Les modèles personnalisés vous permettent d'utiliser votre propre clé API, fournisseur tiers, modèle local ou service de modèles institutionnel. Une fois configuré, BibGenie envoie les requêtes directement du plugin Zotero local vers le fournisseur choisi.
Ajouter un modèle
Comportement d'auto-remplissage
Ajouter un modèle personnalisé n'est pas entièrement manuel. BibGenie charge les informations de fournisseur et de modèle depuis le catalogue models.dev lorsqu'elles sont disponibles :
- Provider ID permet de rechercher des fournisseurs courants et de saisir manuellement un fournisseur personnalisé.
- La sélection d'un fournisseur peut remplir automatiquement Provider Name, Provider Type et Base URL.
- Model ID est filtré selon le fournisseur sélectionné et prend en charge les modèles du catalogue comme les IDs personnalisés.
- La sélection d'un modèle du catalogue peut remplir automatiquement Model Name, Family, Model Types, Context Window, Max Tokens, Description et les métadonnées de prix.
- Si le catalogue de modèles ne peut pas être chargé, BibGenie utilise une liste de fournisseurs de secours intégrée, et vous pouvez toujours ajouter des modèles manuellement.
Préférez les entrées du catalogue lorsqu'elles existent
Si votre fournisseur et votre modèle apparaissent dans les listes de recherche, sélectionnez-les au lieu de tout saisir manuellement. Cela réduit les erreurs de Provider Type, Base URL, capacités du modèle et limites de contexte.
Champs
| Champ | Requis | Description |
|---|---|---|
| Provider ID | Requis | Identifiant unique du fournisseur, comme openai, anthropic ou openrouter ; les IDs personnalisés sont pris en charge |
| Provider Name | Requis | Nom affiché du fournisseur ; généralement auto-rempli depuis le catalogue |
| Model ID | Requis | ID réel du modèle utilisé par l'API du fournisseur, comme gpt-4.1 ou claude-sonnet-4-5 |
| Model Name | Requis | Nom affiché dans BibGenie ; généralement auto-rempli depuis le catalogue |
| API Key | Optionnel | Votre clé API fournisseur ; les fournisseurs locaux comme Ollama n'en demandent généralement pas |
| Base URL | Optionnel | Point d'accès API ; souvent auto-rempli pour les fournisseurs du catalogue, mais les services compatibles ou locaux peuvent nécessiter une confirmation manuelle |
| Provider Type | Requis | Type d'intégration API, comme OpenAI, Anthropic, Ollama ou OpenAI Compatible |
| Family | Optionnel | Famille de modèle, comme qwen, gpt ou claude ; souvent auto-remplie |
| Model Types | Requis | Capacités comme Text, Vision, Reasoning, Function Calling ou Web Search |
| Context Window | Optionnel | Fenêtre de contexte du modèle ; souvent auto-remplie pour les modèles du catalogue |
| Max Tokens | Optionnel | Nombre maximal de tokens de sortie ; souvent auto-rempli pour les modèles du catalogue |
| Description | Optionnel | Description du modèle ; souvent auto-remplie |
Guide Provider Type
| Provider Type | À utiliser lorsque |
|---|---|
| OpenAI | Vous utilisez l'API officielle OpenAI |
| Anthropic | Vous utilisez l'API Anthropic Claude |
| xAI | Vous utilisez l'API xAI Grok |
| DeepSeek | Vous utilisez l'API officielle DeepSeek |
| Vous utilisez l'API Gemini | |
| Groq | Vous utilisez l'API Groq |
| Moonshot AI | Vous utilisez les modèles Kimi / Moonshot |
| OpenRouter | Vous utilisez l'API OpenRouter |
| Alibaba | Généralement via OpenAI Compatible |
| Z.AI / Zhipu AI | Généralement via OpenAI Compatible |
| Ollama | Vous utilisez un service local Ollama |
| OpenAI Compatible | Vous utilisez LM Studio, un proxy API ou un endpoint institutionnel compatible |
Base URL
De nombreux fournisseurs officiels ont une Base URL par défaut. Vous devez généralement modifier Base URL uniquement lorsque :
- Vous utilisez OpenAI Compatible.
- Vous utilisez un proxy API.
- Vous utilisez un service de modèle local.
- Votre fournisseur exige un endpoint personnalisé.
Exemples :
https://api.openai.com/v1
https://openrouter.ai/api/v1
http://localhost:11434
http://localhost:1234/v1Attention au chemin /v1
De nombreuses API compatibles nécessitent une Base URL se terminant par /v1. L'absence du chemin de version peut provoquer des erreurs NetworkError, 404 ou model-not-found.
Exemple Ollama
ollama list dans un terminal pour confirmer qu'un modèle local est disponible.ollama serve. Vous verrez une confirmation indiquant qu'il écoute sur 127.0.0.1:11434.http://localhost:11434 comme Base URL.ollama list, comme llama3.1:8b, comme Model ID.Exemple LM Studio
LM Studio est généralement configuré via OpenAI Compatible :
http://localhost:1234/v1.Model Types
Sélectionnez les capacités selon ce que le modèle prend réellement en charge :
- Text : chat texte ; généralement requis.
- Vision : entrée image, capture d'écran et figure.
- Reasoning : utile pour les tâches de raisonnement complexe.
- Function Calling : influence les flux de recherche, lecture et gestion de bibliothèque.
- Web Search : à activer uniquement si le fournisseur et le modèle le prennent en charge.
Des capacités mal configurées peuvent provoquer ModelNotSupported ou des échecs d'appel d'outils.