Zum Inhalt springen
Entwickler-Ressourcen
Entwickler-Ressourcen

Chatbox AI

Chatbox AI installieren, einen benutzerdefinierten RunAPI-Anbieter hinzufügen, ein Modell abrufen, die Verbindungsprüfung ausführen und einen Chat überprüfen.

Chatbox AI mit einem benutzerdefinierten BYOK-Anbieter mit RunAPI verbinden. Die unten aufgeführten Namen folgen der aktuellen benutzerdefinierten Anbieter-Oberfläche; Bezeichnungen können je nach Desktop-Release leicht variieren. Erstellen Sie einen Standard-RunAPI-API-Schlüssel in der Authentifizierungsanleitung, bevor Sie fortfahren.

Chatbox AI installieren

Laden Sie Chatbox AI von der offiziellen Download-Seite oder den offiziellen Releases herunter und öffnen Sie dann Einstellungen.

RunAPI-Anbieter hinzufügen

  1. Öffnen Sie AI Provider / Model Settings und wählen Sie Add Provider.
  2. Benennen Sie den Anbieter RunAPI und wählen Sie OpenAI API Compatible als API-Modus.
  3. Geben Sie Ihren RunAPI-API-Schlüssel ein.
  4. Setzen Sie API Host auf https://runapi.ai/v1 und API Path auf /chat/completions.
  5. Vergewissern Sie sich, dass die URL-Vorschau auf https://runapi.ai/v1/chat/completions endet, und speichern Sie.

Halten Sie Host und Pfad getrennt. Fetch erstellt die Modell-Discovery aus dem Host mit /models, während der Chat den Host plus den konfigurierten API-Pfad verwendet.

Modell hinzufügen und überprüfen

Wählen Sie Fetch, um den RunAPI-Modellkatalog zu laden. Wenn die Erkennung nicht verfügbar ist, wählen Sie New und geben Sie einen genauen Bezeichner aus dem Modellkatalog ein. Chatbox AI benötigt mindestens ein gespeichertes Modell, bevor Check ausgeführt werden kann.

Wählen Sie Check, wählen Sie das gespeicherte Modell und führen Sie den Verbindungstest aus. Behandeln Sie eine erfolgreiche Text Request als Basisindikator. Vision Request und Tool Use Request hängen von den Fähigkeiten des ausgewählten Modells ab und können unabhängig voneinander fehlschlagen, ohne den grundlegenden Text-Chat zu beeinträchtigen.

Verbindung überprüfen

Starten Sie einen neuen Chat, wählen Sie das gespeicherte RunAPI-Modell in der Modellauswahl und senden Sie Reply with the word connected. Eine normale Antwort bestätigt, dass der benutzerdefinierte Anbieter aktiv ist.

Fehlerbehebung

  • Die URL-Vorschau ist falsch: Verwenden Sie Host https://runapi.ai/v1 und Pfad /chat/completions; geben Sie nicht die vollständige Operations-URL in beide Felder ein.
  • Check ist deaktiviert oder hat kein Modell: Verwenden Sie Fetch oder New, um zuerst mindestens ein Modell hinzuzufügen.
  • Text Request schlägt mit einem Authentifizierungsfehler fehl: Aktualisieren Sie den Provider mit einem gültigen Standard-Schlüssel aus der Authentifizierungsanleitung.
  • Text funktioniert, aber Vision oder Tool Use schlägt fehl: Wählen Sie ein Modell, das die erforderliche Fähigkeit im Modellkatalog deklariert; diese Prüfungen sind keine universellen Provider-Anforderungen.

Für das gemeinsame Protokollverhalten verwenden Sie den LLM API Quickstart. Für Anfrage- und Antwortfelder verwenden Sie die Chat Completions API Referenz.