BibGenie-DokumentationEigene Modelle (Custom Models)
Füge eigene Modelle hinzu und verwalte sie, einschließlich OpenAI, Anthropic, OpenRouter, Ollama, LM Studio und kompatibler APIs.
Custom Models ermöglichen dir, deinen eigenen API-Schlüssel, Drittanbieter-Provider, lokales Modell oder institutionellen Modelldienst zu verwenden. Nach der Konfiguration sendet BibGenie Anfragen direkt vom lokalen Zotero-Plugin an den von dir gewählten Provider.
Modell hinzufügen
Auto-Fill-Verhalten
Ein eigenes Modell hinzuzufügen ist nicht vollständig manuell. BibGenie lädt Provider- und Modellinformationen aus dem models.dev-Katalog, wenn verfügbar:
- Provider ID unterstützt das Suchen häufiger Provider und die manuelle Eingabe eigener Provider.
- Die Auswahl eines Providers kann Provider Name, Provider Type und Base URL automatisch ausfüllen.
- Model ID wird nach dem ausgewählten Provider gefiltert und unterstützt sowohl Katalogmodelle als auch eigene Modell-IDs.
- Die Auswahl eines Katalogmodells kann Model Name, Family, Model Types, Context Window, Max Tokens, Description und Preismetadaten automatisch ausfüllen.
- Wenn der Modellkatalog nicht geladen werden kann, verwendet BibGenie eine eingebaute Fallback-Providerliste; du kannst Modelle weiterhin manuell hinzufügen.
Katalogeinträge bevorzugen, wenn verfügbar
Wenn dein Provider und Modell in den Such-Dropdowns erscheinen, wähle sie aus, statt alles manuell einzugeben. Das reduziert Fehler bei Provider Type, Base URL, Modellfähigkeiten und Kontextlimits.
Felder
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| Provider ID | Erforderlich | Eindeutige Providerkennung, etwa openai, anthropic oder openrouter; eigene IDs werden unterstützt |
| Provider Name | Erforderlich | Anzeigename des Providers; normalerweise aus dem Katalog automatisch ausgefüllt |
| Model ID | Erforderlich | Tatsächliche Modell-ID der Provider-API, etwa gpt-4.1 oder claude-sonnet-4-5 |
| Model Name | Erforderlich | In BibGenie angezeigter Name; normalerweise aus dem Katalog automatisch ausgefüllt |
| API Key | Optional | Dein Provider-API-Schlüssel; lokale Provider wie Ollama benötigen normalerweise keinen |
| Base URL | Optional | API-Endpunkt; für Katalogprovider oft automatisch ausgefüllt, kompatible oder lokale Dienste erfordern aber eventuell manuelle Bestätigung |
| Provider Type | Erforderlich | API-Integrationstyp, etwa OpenAI, Anthropic, Ollama oder OpenAI Compatible |
| Family | Optional | Modellfamilie, etwa qwen, gpt oder claude; oft automatisch ausgefüllt |
| Model Types | Erforderlich | Fähigkeiten wie Text, Vision, Reasoning, Function Calling oder Web Search |
| Context Window | Optional | Kontextfenster des Modells; bei Katalogmodellen oft automatisch ausgefüllt |
| Max Tokens | Optional | Maximale Ausgabetokens; bei Katalogmodellen oft automatisch ausgefüllt |
| Description | Optional | Modellbeschreibung; oft automatisch ausgefüllt |
Provider Type-Leitfaden
| Provider Type | Verwenden, wenn |
|---|---|
| OpenAI | Du die offizielle OpenAI API verwendest |
| Anthropic | Du die Anthropic Claude API verwendest |
| xAI | Du die xAI Grok API verwendest |
| DeepSeek | Du die offizielle DeepSeek API verwendest |
| Du die Gemini API verwendest | |
| Groq | Du die Groq API verwendest |
| Moonshot AI | Du Kimi / Moonshot-Modelle verwendest |
| OpenRouter | Du die OpenRouter API verwendest |
| Alibaba | Normalerweise über OpenAI Compatible |
| Z.AI / Zhipu AI | Normalerweise über OpenAI Compatible |
| Ollama | Du einen lokalen Ollama-Dienst verwendest |
| OpenAI Compatible | Du LM Studio, einen API-Proxy oder einen institutionellen kompatiblen Endpunkt verwendest |
Base URL
Viele offizielle Provider haben eine Standard-Base URL. Du musst Base URL normalerweise nur ändern, wenn:
- Du OpenAI Compatible verwendest.
- Du einen API-Proxy verwendest.
- Du einen lokalen Modelldienst verwendest.
- Dein Provider einen eigenen Endpunkt verlangt.
Beispiele:
https://api.openai.com/v1
https://openrouter.ai/api/v1
http://localhost:11434
http://localhost:1234/v1Auf den /v1-Pfad achten
Viele kompatible APIs benötigen eine Base URL, die auf /v1 endet. Fehlt der Versionspfad, kann es zu NetworkError, 404 oder model-not-found-Fehlern kommen.
Ollama-Beispiel
ollama list in einem Terminal aus, um zu prüfen, ob ein lokales Modell verfügbar ist.ollama serve. Die Ausgabe bestätigt, dass es auf 127.0.0.1:11434 lauscht.http://localhost:11434 als Base URL.ollama list angezeigten Modellnamen, etwa llama3.1:8b, als Model ID.LM Studio-Beispiel
LM Studio wird normalerweise über OpenAI Compatible konfiguriert:
http://localhost:1234/v1.Model Types
Wähle Fähigkeiten entsprechend dem, was das Modell tatsächlich unterstützt:
- Text: Textchat; normalerweise erforderlich.
- Vision: Eingabe von Bildern, Screenshots und Abbildungen.
- Reasoning: nützlich für komplexe Reasoning-Aufgaben.
- Function Calling: beeinflusst Suche, Lesen und Bibliotheksverwaltungs-Workflows.
- Web Search: nur aktivieren, wenn Provider und Modell dies unterstützen.
Falsche Fähigkeitseinstellungen können ModelNotSupported oder Tool-Calling-Fehler verursachen.