Zed mit eigenen Modellen einrichten: API Key und Base URL
Füge BetterToken in Zed als OpenAI-kompatiblen Provider hinzu, konfiguriere Base URL, API Key und Modell und speichere den Key im System-Schlüsselbund.
Füge in Zed unter Agent Settings einen OpenAI-kompatiblen Provider hinzu und trage dann BetterToken API Key, Base URL und Model ID ein. Zed speichert über diesen Bildschirm gespeicherte Keys im System-Schlüsselbund statt in settings.json.
Wichtige Einstellungen
| Feld | Wert |
|---|---|
| Provider | BetterToken |
| API Key | YOUR_API_KEY |
| Base URL | https://bettertoken.ai/v1 |
| Model | YOUR_MODEL_ID |
Voraussetzungen
- Installiere die aktuelle Version von Zed
- Erstelle einen BetterToken API Key
- Kopiere
YOUR_MODEL_IDaus der model plaza
Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.
Installation
Installiere oder aktualisiere auf die aktuelle Version von der Zed-Website. Starte Zed und verwende dann die folgenden Schritte, um die Agent-Einstellungen zu öffnen.
Manuelle Einrichtung
OpenAI-kompatiblen Provider hinzufügen
Klicke auf Add Provider, wähle OpenAI Compatible und trage BetterToken als Provider Name ein.
Verbindungseinstellungen eingeben
| Feld | Wert |
|---|---|
| API URL | https://bettertoken.ai/v1 |
| API Key | YOUR_API_KEY |
| Model ID | YOUR_MODEL_ID |
Trage nur die Base URL ein. Diese Anleitung verwendet den standardmäßigen Chat-Completions-Modus von Zed, der den Endpunktpfad automatisch ergänzt.
API Key speichern
Speichere den Provider in den Zed-Einstellungen. Zed speichert den API Key im lokalen System-Schlüsselbund und schreibt ihn nicht in settings.json.
Modell auswählen
Öffne die Modellauswahl im Agent Panel und wähle YOUR_MODEL_ID unter BetterToken aus.
Optional: Provider und Modell in settings.json deklarieren
Wenn du dateiverwaltete Modelldeklarationen benötigst, führe zed: open settings file aus. Belasse nur Provider, api_url und Modellmetadaten in der Datei:
{ "language_models": { "openai_compatible": { "BetterToken": { "api_url": "https://bettertoken.ai/v1", "available_models": [ { "name": "YOUR_MODEL_ID", "display_name": "YOUR_MODEL_ID", "max_tokens": 128000 } ] } } }}Zed benötigt max_tokens als Deklaration des Modell-Kontextfensters. Passe den Wert an das ausgewählte Modell an. Trage den API Key in Agent Settings ein, damit ihn der System-Schlüsselbund speichert.
Verbindung überprüfen
- Wähle
BetterToken / YOUR_MODEL_IDim Agent Panel aus. - Sende eine kurze Testnachricht.
- Eine normale Antwort ohne Authentifizierungs- oder Modellfehler bestätigt die Einrichtung.
Beende Zed vollständig und starte es neu, nachdem du Provider- oder Modelleinstellungen geändert hast.
Modelle wechseln
Wähle in der Modellauswahl des Agent Panels ein anderes BetterToken-Modell. Um eine Model ID hinzuzufügen, kopiere den aktuellen Wert aus der model plaza und aktualisiere dann die Provider-Einstellungen oder available_models.
Häufige Fehler
| Fehler | Lösung |
|---|---|
401 oder Unauthorized | Trage den BetterToken API Key erneut in Agent Settings ein und entferne umgebende Leerzeichen. |
404 | Verwende https://bettertoken.ai/v1 als API URL; hänge nicht /chat/completions an. |
model not found | Kopiere YOUR_MODEL_ID erneut aus der model plaza. |
| Einstellungen werden nicht übernommen | Speichere den Provider, beende Zed vollständig und öffne es erneut. |
| Zed verwendet einen alten Key | Prüfe die aus deiner Provider-ID abgeleitete Variable: Großbuchstaben in Snake Case plus _API_KEY, beispielsweise BETTERTOKEN_API_KEY für BetterToken. Ein nicht leerer Wert hat Vorrang vor dem Schlüsselbund. Entferne die Variable und starte Zed neu, um den gespeicherten Key zu verwenden. Siehe Zeds Vorrangregeln für Keys. |
Technische Details
Schlüsselbund, Einstellungsdatei und Endpunkt
Zed ruft BetterToken über einen OpenAI-kompatiblen Provider auf. Der Einstellungsbildschirm speichert den Key im System-Schlüsselbund; settings.json enthält nur die Provider-, api_url- und Modelldeklaration. Verwende mit den standardmäßigen Chat-Completions-Einstellungen dieser Anleitung https://bettertoken.ai/v1 als Base URL und lasse Zed den Endpunktpfad anhängen.

