Chatbox ist ein plattformübergreifender KI-Client für Desktop und Mobilgeräte, der mehrere Modellanbieter unterstützt. Es gibt zwei typische Nutzungsarten: den integrierten Chatbox-AI-Dienst oder den eigenen API-Key für eigene Modelle. Dieser Artikel behandelt ausschließlich die zweite Variante: wie Chatbox an eine eigene OpenAI-kompatible API angebunden wird.

Hinweis: Chatbox ist ein Produkt seines jeweiligen Inhabers; dieser Artikel dient ausschließlich der technischen Anleitung. Menünamen und Feldpositionen können sich je nach Version unterscheiden; maßgeblich ist die aktuelle Version. Modelle und Preise entnehmen Sie den Modellpreisen.

1. Zuerst den passenden Modus wählen

Modus Abrechnung Konfigurationsort Geeignet für
Chatbox AI Nach dem Client-Tarif Anmeldung mit Konto Nutzer, die keinen eigenen Key verwalten möchten
Eigener API Key Nutzungsabhängig über den API-Anbieter Einstellungen für Modellanbieter Teams mit vorhandenem Gateway oder Modellkonto
Lokales Modell Abhängig von der lokalen Hardware Lokaler Inferenzdienst Szenarien, in denen Daten das Gerät nicht verlassen dürfen

Beide Modi können parallel bestehen. Geben Sie eigenen Anbietern einen eindeutigen Namen, etwa „ZSQH“, damit sie nicht mit dem integrierten Dienst verwechselt werden. Prüfen Sie beim Modellwechsel, welcher Anbieter im aktuellen Dialog aktiv ist.

2. Drei Parameter vorbereiten

  1. API-Schlüssel: Im ZSQH AI Gateway anlegen und nach Projekt benennen.
  2. API-Host: Die OpenAI-kompatible Adresse, üblicherweise https://ai.zhongshangqihang.com/v1.
  3. Modell-ID: Die exakte API-Kennung von der Seite Modellpreise kopieren.

Prüfen Sie zuerst per curl, um Probleme auf der Gateway-Seite auszuschließen:

export ZSQH_API_KEY="sk-ihr-schluessel"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ihre-modell-id",
    "messages": [{"role": "user", "content": "Antworte nur mit OK"}]
  }'

Erscheint choices in der Antwort, sind Key, Adresse und Modell gültig; es bleibt nur die Bedienung im Client.

3. Eigenen Modellanbieter hinzufügen

Der Ablauf in der verbreiteten aktuellen Version (die genaue Schaltflächenbeschriftung richtet sich nach Ihrer Version):

  1. Chatbox öffnen und unten links „Einstellungen“ aufrufen.
  2. Links „Modellanbieter“ wählen und unten auf „+ Hinzufügen“ klicken.
  3. Einen gut erkennbaren Namen für den Anbieter vergeben.
  4. Als API-Modus OpenAI-kompatibel oder die entsprechende OpenAI-Option wählen.
  5. API-Schlüssel und API-Host eintragen.
  6. Auf „Abrufen“ klicken, um die Modellliste zu laden, oder die Modell-ID manuell eintragen.
  7. Auf „Prüfen“ klicken, die Verbindung testen und das gerade hinzugefügte Modell auswählen.

Schlägt „Abrufen“ fehl, ist der Key nicht zwingend falsch; möglicherweise bietet das Gateway keine Modelllisten-Schnittstelle. Tragen Sie in diesem Fall die Modell-ID direkt ein und prüfen Sie anschließend mit „Prüfen“.

4. API-Host und /v1

Die Base URL ist die häufigste Fehlerquelle bei einer eigenen API. Prüfen Sie die Angaben anhand dieser Tabelle:

Punkt Empfohlener Wert Hinweis
API-Modus OpenAI-kompatibel Nicht den Anthropic- oder Gemini-Modus wählen
API-Host https://ai.zhongshangqihang.com/v1 Kein abschließender Schrägstrich
API-Schlüssel sk-... Keine Leerzeichen davor oder dahinter
Modell-ID Laut Preisseite Groß-/Kleinschreibung und Versions-Suffix beachten

Meldet die vollständige Adresse 404, versuchen Sie es ohne /v1; meldet nur die Domain 404, ergänzen Sie /v1. Verschiedene Client-Versionen setzen Pfade unterschiedlich zusammen; maßgeblich ist das tatsächliche Anfrageergebnis. Bei 401 prüfen Sie zuerst den Key, bei 404 zuerst den Pfad. Diese Reihenfolge spart viel Zeit.

5. Modell-ID und Fähigkeiten konfigurieren

Beim manuellen Hinzufügen eines Modells wählen Sie meist auch Modelltyp und Fähigkeiten. Typische Zuordnungen:

Modelltyp Zweck Zu aktivierende Fähigkeiten
Chat-Modell Fragen, Texte, Übersetzung Text, Streaming
Reasoning-Modell Komplexe Analyse, Planung Reasoning- oder Denkprozess
Bildmodell Bildverständnis, Fragen zu Screenshots Bildeingabe
Tool-Modell Funktionsaufrufe, Plugins Tool-Aufrufe

Bei falschem Modelltyp erscheint das Modell möglicherweise nicht im Chat-Auswahlmenü; fehlen aktivierte Fähigkeiten, schlagen Bild-Uploads oder Tool-Aufrufe fehl. Wenn Sie unsicher sind, konfigurieren Sie zuerst nur Text-Chat und ergänzen Sie Fähigkeiten schrittweise.

6. Verbindung prüfen

Die Funktion „Prüfen“ im Client testet üblicherweise Text, Bilder und Tool-Aufrufe getrennt. Bestätigen Sie mindestens eine erfolgreiche Textanfrage. Sicherer ist eine echte Frage, bei der Sie drei Dinge beobachten:

  1. Ob das erste Zeichen normal zurückkommt oder lange ein Ladekreis erscheint.
  2. Ob mehrstufige Dialoge den Kontext behalten.
  3. Ob lange Antworten mittendrin abbrechen.

Bricht nur die lange Antwort ab, prüfen Sie zuerst Netzwerk-Proxy und Streaming. Scheitern alle Anfragen, kehren Sie zu Key und Base URL zurück. Sie können auf dem Rechner zusätzlich mit Proxy-Software vergleichen, dürfen die Proxy-Adresse aber nicht als API-Host eintragen.

7. Häufige Fehler und Behandlung

Symptom Häufige Ursache Behandlung
401 Unauthorized Key falsch, abgelaufen oder gelöscht Key neu erzeugen, auf Leerzeichen prüfen
404 Not Found Falscher Pfad im API-Host /v1 ergänzen oder entfernen und erneut versuchen
model not found Modell-ID falsch oder nicht freigeschaltet Von der Preisseite kopieren
Verbindungs-Timeout Netzwerk nicht erreichbar oder Proxy blockiert Netzwerk wechseln, Firewall prüfen
Antwort bricht ab Streaming-Verbindung unterbrochen Streaming testweise deaktivieren
429 Too Many Requests Parallelität oder Kontingent begrenzt Parallelität senken, Gateway-Verbrauch prüfen
Bild-Upload schlägt fehl Modell ohne Vision oder Fähigkeit nicht aktiviert Bildmodell wählen und Bildeingabe aktivieren

Ändern Sie bei der Fehlersuche immer nur eine Variable. Wenn Sie Key, Adresse und Modell gleichzeitig ändern, wissen Sie auch nach der Behebung nicht, welcher Schritt geholfen hat, und treten beim nächsten Mal in dieselbe Falle.

8. Sicherheit und Kosten

  1. Sowohl Mobil- als auch Desktop-Clients können Keys speichern; bei gemeinsam genutzten Geräten ist Vorsicht geboten.
  2. Stellen Sie für Chatbox einen eigenen Key aus, damit er jederzeit widerrufen werden kann.
  3. Setzen Sie gatewayseitig ein Budgetlimit, damit Dauerbetrieb das Kontingent nicht aufbraucht.
  4. Fügen Sie keine Produktionsschlüssel, Kundenlisten oder Vertragstexte in Dialoge ein.
  5. Exportieren oder sichern Sie wichtige Gespräche regelmäßig; eine Deinstallation des Clients ist kein Cloud-Backup.
  6. Bei Team-Nutzung Keys pro Person ausgeben, damit sich der Verbrauch trennen lässt.

Häufige Fragen

Fallen mit eigenem API Key zusätzlich Abogebühren an?

Im Modus mit eigenem Key erhebt der API-Anbieter die Modellkosten nutzungsabhängig; die Abrechnung des Chatbox-Clients selbst richtet sich nach der aktuellen Version. Beide Kostenarten sollten getrennt betrachtet werden.

Warum schlägt „Modellliste abrufen“ dauerhaft fehl?

Möglicherweise bietet das Gateway keine Modelllisten-Schnittstelle, oder der Pfad der Base URL ist falsch. Fügen Sie zuerst eine Modell-ID manuell hinzu. Funktioniert das, fehlt lediglich die Listen-Schnittstelle.

Muss /v1 an den API-Host angehängt werden?

Die meisten OpenAI-kompatiblen Konfigurationen benötigen /v1. Scheitern beide Varianten, bestätigen Sie zuerst per curl die korrekte vollständige Anfrageadresse und tragen Sie diese in den Client ein, statt zu raten.

Lassen sich mehrere Anbieter gleichzeitig konfigurieren?

Ja. Geben Sie jedem Anbieter einen eigenen Namen und wählen Sie das Modell im Dialog bewusst aus. Bei mehreren Anbietern passiert am leichtesten Folgendes: Man glaubt, mit A zu arbeiten, während die Anfrage an B geht.

Funktioniert Chatbox direkt auf dem Smartphone?

Sie können die mobile Version installieren und einen eigenen Anbieter konfigurieren; Einstiegspunkte und verfügbare Funktionen unterscheiden sich jedoch je nach Plattform und Version. Sensible Keys sollten nicht dauerhaft auf dem Smartphone gespeichert werden.

Nächste Schritte

Die Chatbox-Konfiguration hat drei Kernpunkte: API-Host, Key und Modell-ID. Prüfen Sie zuerst per curl, bevor Sie den Client öffnen. Bei Fehlern gilt: 401 auf den Key, 404 auf den Pfad, model not found auf die Modell-ID. Für einen einheitlichen Einstieg und Verbrauchsverwaltung können Sie sich im ZSQH AI Gateway registrieren; Modelle und Preise stehen auf der Seite Modellpreise.

Weiterlesen: