Einen Modellanbieter verbinden
API-Typ, Endpunkt, API-Schlüssel und Modell-ID eintragen, den Aufbau der Anfrage-URL verstehen und häufige Verbindungsfehler beheben.
Der AI Reader nutzt den in den Einstellungen ausgewählten Anbieter. Ihr Anbieterkonto bestimmt verfügbare Modelle und Kosten. Dateien lesen und durchsuchen funktioniert ohne diese Verbindung.
Einen Anbieter hinzufügen
Öffnen Sie Einstellungen → Modelle, klicken Sie auf Anbieter hinzufügen (Plus-Button) und wählen Sie den neuen Eintrag als Aktueller Anbieter. Vergeben Sie einen erkennbaren Namen, etwa „Team-Gateway“. Der Name ist nur eine Bezeichnung und beeinflusst die verwendete API nicht.
Tragen Sie dann Folgendes ein:
| Feld | Eintrag |
|---|---|
| API-Typ | Protokoll des Dienstes: OpenAI Chat Completions, OpenAI Responses oder Anthropic Messages |
| Endpunkt | Dienst-URL einschließlich aller vom Gateway benötigten Pfadpräfixe |
| Authentifizierung / API-Schlüssel | Ihr API-Schlüssel oder die vom Anbieter angebotene Anmeldung |
| Modell | Exakte Modell-ID, die Ihr Konto verwenden darf |
Geben Sie API-Schlüssel nur in den Einstellungen ein, nie in Gesprächen oder Projektdateien. Manche Anbieter bieten eine Kontoanmeldung statt eines Schlüssels an. Wählen Sie diese gegebenenfalls unter Anmeldemethode.
Endpunkt und API-Typ abstimmen
Der Modellname verrät das Protokoll nicht: Ein Gateway kann ähnlich benannte Modelle über verschiedene APIs bereitstellen. Folgen Sie der API-Dokumentation des Dienstes und behalten Sie erforderliche Pfadpräfixe bei.
Diese URLs zeigen den Aufbau von Yenpos Anfrage-URL. Sie sind Beispiele, keine funktionsfähigen Dienste:
| API-Typ | Beispiel für das Endpunktfeld | Resultierende Anfrage-URL |
|---|---|---|
| Chat Completions | https://gateway.example/v1 |
https://gateway.example/v1/chat/completions |
| Responses | https://gateway.example |
https://gateway.example/v1/responses |
| Messages | https://gateway.example |
https://gateway.example/v1/messages |
Endet der Endpunkt bereits auf /chat/completions, /responses oder /messages, nutzt Yenpo ihn beim passenden API-Typ unverändert. Für Responses und Messages wird bei einem Endpunkt mit /v1 das letzte Segment angefügt. Chat Completions hängt immer /chat/completions an Ihre Eingabe an und ergänzt kein fehlendes /v1.
Wechseln Sie bei einem Fehler nicht wahllos zwischen API-Typen. Klären Sie, welches Protokoll der Dienst unterstützt und wie der vollständige Anfragepfad aussehen muss.
Modell-ID
Tragen Sie die Modell-ID unter Modell ein oder klicken Sie auf Liste laden, falls der Dienst eine Modellliste veröffentlicht. Listenabruf und Modellaufruf sind getrennte Anfragen; das Modell kann funktionieren, auch wenn der Abruf fehlschlägt. Versuchen Sie, die dokumentierte ID direkt einzugeben.
Kontextlänge beeinflusst Yenpos Eingabe- und Ausgabebudgets, den Zeitpunkt der Gesprächszusammenfassung und den danach behaltenen Kontext. Tragen Sie das dokumentierte Modelllimit ein; ein leeres Feld nutzt Yenpos Standard. Ein zu kleiner Wert führt zu unnötiger Zusammenfassung, ein zu großer zu möglicherweise abgelehnten Anfragen.
Preise dienen zur Berechnung der geschätzten Kosten in den Ausführungsdetails. Verwenden Sie die Tarife Ihres Anbieters; diese Werte ändern weder reale Gebühren noch Modellzugriff. Lassen Sie andere Modelleinstellungen unverändert, während Sie die erste Verbindung einrichten.
Bildeingaben sind je Anbieter standardmäßig deaktiviert. Aktivieren Sie Bilder akzeptieren nur, wenn Modell und API die vorgesehenen Bilder unterstützen.
Mit einer kleinen Frage testen
Öffnen Sie eine kleine Datei, die Sie an diesen Dienst senden dürfen, und fragen Sie:
Was gibt diese Funktion bei leerer Eingabe zurück? Zitiere den relevanten Zweig.
Kommt eine Antwort zurück, funktioniert die Verbindung. Ob die Antwort richtig ist, müssen Sie getrennt am Code prüfen.
Eine Anfrage enthält Ihre Nachricht und relevanten Code, den der AI Reader im Projekt findet, nicht nur Ihre Eingabe. Lesen Sie Daten, Bearbeitungsrechte und Terminal, bevor Sie vertraulichen Code an einen entfernten Endpunkt senden.
Wenn eine Anfrage fehlschlägt
| Symptom | Prüfen |
|---|---|
| Authentifizierungs- oder Berechtigungsfehler | Gewähltes Konto oder Schlüssel, Betreiber des Endpunkts, Modellzugriff |
| Nicht gefunden oder API nicht unterstützt | API-Typ und vollständiger Anfragepfad einschließlich Gateway-Präfixen |
| Modell nicht gefunden | Exakte Modell-ID und Zugriffsrechte Ihres Kontos |
| Modellabruf schlägt fehl | Ob der Dienst überhaupt Modelle auflistet; dokumentierte ID direkt eingeben |
| Zeitüberschreitung oder unterbrochener Stream | Netzwerkzugriff, Proxy- oder Gateway-Verhalten, Verfügbarkeit des Anbieters |
Ein HTTP-Status allein erklärt selten die Ursache; Gateways können vorgelagerte Fehler umschreiben. Geben Sie bei Problemmeldungen Fehlermeldung, API-Typ und den von privaten Angaben bereinigten Endpunkt an. Fügen Sie niemals den API-Schlüssel hinzu.
Wurde eine Ausführung mit erlaubten Änderungen unterbrochen, prüfen Sie vor dem Wiederholen den Arbeitsbaum. Dateien können geändert worden sein, obwohl keine abschließende Antwort ankam.