Droid einrichten: API Key, Base URL und Modelle

Um Droid mit BetterToken zu verbinden, bereite einen API Key vor, trage die unten angezeigte Base URL ein und wähle eine aktuelle Model ID aus der model plaza.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	Eine aktuelle Model ID aus der model plaza

Voraussetzungen

• Die aktuelle Version des Tools ist installiert
• Ein BetterToken API Key: Registriere dich und erhalte einen
• Eine Model ID aus der model plaza

Registrieren und BetterToken API Key erhalten→

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Zusätzliche Anforderungen

Installation

Droid installieren

macOS / Linux

curl -fsSL https://app.factory.ai/cli | sh

Windows

irm https://app.factory.ai/cli/windows | iex

Manuelle Einrichtung

Du kannst ein Modell in der CLI über /settings → Custom models oder /model → Manage custom models hinzufügen. Öffne in der Desktop-App Settings → Custom Models. Beide Editoren speichern in ~/.factory/settings.json; die folgende Dateikonfiguration ist eine Alternative. Siehe die Anleitung für eigene Modelle von Factory.

Feld	Wert
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	Eine aktuelle Model ID aus der model plaza

Einrichtung

BetterToken API Key setzen

macOS / Linux

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

Ersetze YOUR_API_KEY durch deinen BetterToken API Key. Droid unterstützt die Erweiterung der Umgebungsvariable ${BETTERTOKEN_API_KEY} in seiner JSON-Konfiguration.

Droid-Konfigurationsdatei bearbeiten

Pfad der Konfigurationsdatei: ~/.factory/settings.json

{
  "customModels": [
    {
      "displayName": "BetterToken Codex",
      "model": "YOUR_MODEL_ID",
      "baseUrl": "https://bettertoken.ai/v1",
      "apiKey": "${BETTERTOKEN_API_KEY}",
      "provider": "openai"
    }
  ]
}

Ersetze YOUR_MODEL_ID durch eine aktuelle Model ID aus der model plaza.

Droid starten und Modell auswählen

cd /path/to/your/project
droid

Gib /model in Droid ein und wähle BetterToken Codex. Factory überwacht Änderungen in der Einstellungsdatei; wenn die Modellliste nicht aktualisiert wird, beende und starte Droid erneut.

Kleine Testaufgabe ausführen

Beginne mit einer kleinen Aufgabe wie „Erkläre die Verzeichnisstruktur dieses Projekts.“ Sobald Droid ein Ergebnis liefert, fahre mit dateiübergreifenden Änderungen oder längeren Agent-Aufgaben fort.

Setze provider auf openai. In der BYOK-Konfiguration von Factory wählt dieser Wert die OpenAI Responses API aus. Verwende https://bettertoken.ai/v1 und einen BetterToken API Key. Für Chat Completions setzt du provider auf generic-chat-completion-api; die Base URL bleibt gleich.

Im Test mit Droid 0.248.0 in einem neuen Profil ohne Factory-Anmeldung war droid exec --model custom:YOUR_MODEL_ID "Reply with only: OK" mit beiden Werten erfolgreich: openai sendete die Anfragen an /v1/responses, generic-chat-completion-api an /v1/chat/completions. Verwende droid exec für eine nicht interaktive Prüfung.

Verbindung überprüfen

Sende eine kurze Testanweisung. Wenn das Tool ohne Authentifizierungs- oder Model-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.

Modelle wechseln

Öffne die Modellauswahl oder ändere das Feld Model in der Konfiguration. Verwende die genaue Model ID aus der model plaza und starte dann die aktuelle Sitzung neu.

Häufige Fehler

Fehlerbehebung

Symptom	Prüfen
Das eigene Modell fehlt in /model	Validiere das JSON und bestätige, dass model, baseUrl, apiKey und provider vorhanden sind
Invalid provider	Verwende den exakten Wert "openai" oder "generic-chat-completion-api" in Kleinbuchstaben, keine Anzeigebezeichnung aus der Oberfläche
401 oder 403	Kopiere den API Key erneut, bestätige, dass der Droid-Prozess BETTERTOKEN_API_KEY lesen kann, und prüfe dein Kontoguthaben
404 oder Model not found	Verwende https://bettertoken.ai/v1 und kopiere eine aktuelle GPT Model ID aus der model plaza
Das alte Modell bleibt nach der Bearbeitung	Öffne /model erneut; wenn es sich weiterhin nicht aktualisiert, beende und starte Droid vollständig neu

FAQ

Modell konfigurieren

Kopieren Sie die genaue Model ID aus der model plaza.

Setze provider auf openai, um die OpenAI Responses API mit der Base URL https://bettertoken.ai/v1 zu verwenden, oder auf generic-chat-completion-api für Chat Completions.

Benötige ich eigene Header?

Für eine Standard-BetterToken-Einrichtung sind keine zusätzlichen Header erforderlich. Füge Tenant-, Routing- oder Audit-Header nur hinzu, wenn ein anderes Gateway sie ausdrücklich verlangt.

Wo kann ich Preise und Nutzung prüfen?

Verwende die Live-model plaza für aktuelle Modellpreise. Request-Nutzung und Guthaben sind im BetterToken Dashboard verfügbar.

Verwandte FAQ

• OpenAI-kompatible API und Anthropic-kompatible API: Unterschiede
• MCP, API Key und Base URL: Unterschiede
• Was sind model_provider, base_url und wire_api?
• OpenAI-kompatible API in Cline konfigurieren

Advanced setup

Verwandte Anleitungen

• Factory-BYOK-Übersicht
• Alle unterstützten Tools vergleichen
• API-Fehler, Statuscodes und Ratenbegrenzungen

Technische Details

Protokoll, Endpunkt und interne Provider-Felder

Diese Einrichtung verwendet https://bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge /chat/completions oder /responses nicht hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.