Jedes Catalog-Modell in Chatbox mit einem Custom Provider.

Updated 2026-07-29

Chatbox bietet einen Add-Custom-Provider-Flow für jeden OpenAI-kompatiblen Endpoint: OpenAI-API-Compatible-Modus wählen, API Host auf https://api.apisrouter.com/v1 setzen, einen Key einfügen — und Claude, GPT, Gemini und DeepSeek sitzen nebeneinander im Modell-Picker auf Desktop, Mobile und Web.

Kurzantwort: ein Dialog in den Model-Provider-Einstellungen.

Öffne die Chatbox-Settings und wechsle zum Tab Model Provider. Klicke auf Add, dann auf Add Custom Provider. Fülle den Dialog mit fünf Werten: einem Namen (APIsRouter), API Mode auf OpenAI API Compatible gesetzt, deinem Key in API Key, https://api.apisrouter.com/v1 in API Host, und lass API Path auf dem /chat/completions-Standard, den Chatbox für einen auf /v1 endenden Host selbst befüllt. Füge dann Modelle hinzu. Der Fetch-Button zieht die Modell-Liste des Endpoints über /v1/models, sodass du IDs direkt aus dem Katalog aktivieren kannst, und New lässt dich eine ID von Hand eintippen, wenn du einen kurzen, kuratierten Picker bevorzugst. Klicke auf Check neben dem Key-Feld, und Chatbox führt eine Live-Anfrage aus; eine grüne Bestätigung bedeutet, der Provider ist verdrahtet. Wir haben genau diesen Flow gegen die aktuelle Chatbox-Web-App validiert, und derselbe Dialog läuft in den Desktop- und Mobile-Builds.

Wie Chatbox mit einem Custom Provider spricht.

Chatbox (chatboxai auf GitHub, rund 41K Stars) ist einer der meistinstallierten KI-Chat-Clients: native Apps für Windows, macOS und Linux, Mobile-Builds für iOS und Android und eine Browser-Version unter web.chatboxai.app. Es liefert vorkonfigurierte Einträge für die großen Vendoren, jeder mit eigenem Key, und der Custom-Provider-Dialog ist der dokumentierte Weg für alles andere. Ein Custom Provider im Modus OpenAI API Compatible ist eine schlichte Beschreibung eines Endpoints: Host, Pfad, Key und eine Liste von Modell-IDs. Jede Konversations-Runde wird zu einer Standard-Chat-Completions-Anfrage gegen diesen Host, wobei die Modell-ID aus dem Picker als String mitreist. Chatbox interessiert nicht, welcher Vendor das Modell hinter einer ID trainiert hat, und genau das macht ein Multi-Vendor-Gateway hier nützlich: ein Provider-Eintrag stellt claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash und deepseek-v4-flash in denselben Picker, abgerechnet über denselben Key. Der praktische Unterschied zum Stapeln von vier First-Party-Providern ist nicht nur weniger Keys. Chatbox-Einstellungen synchronisieren pro Gerät, also ist jedes hinzugefügte Vendor-Konto ein weiterer Key, den du auf dein Handy, deinen Laptop und die Web-App einfügen musst. Ein Custom Provider ist ein Einfügen pro Gerät, und eine Konversation von Claude zu DeepSeek zu wechseln ist ein Picker-Wechsel statt ein Provider-Wechsel.

Vollständiges Setup: jedes Feld im Dialog.

Name ist nur ein Label; APIsRouter hält den Picker lesbar. API Mode muss OpenAI API Compatible sein, was Chatbox sagt, Standard-Chat-Completions zu sprechen; der andere Modus im Dropdown ist für Gemini-native Endpoints gedacht und nicht das, was ein Gateway will. API Host und API Path setzen sich zur Request-URL zusammen, und dieses Paar ist, wo Setups schiefgehen. Mit dem Host auf https://api.apisrouter.com/v1 ist der Path /chat/completions, und Chatbox befüllt genau das, wenn es einen /v1-Host erkennt. Die Chatbox-Doku beschreibt auch die Bare-Host-Konvention, bei der der Host /v1 auslässt und der Path standardmäßig /v1/chat/completions ist; beide setzen sich zur selben URL zusammen, also eine Form wählen und das andere Feld auf seinem Standard lassen. Was kaputtgeht, ist das Mischen beider — ein /v1-Host mit einem /v1/chat/completions-Path —, was eine verdoppelte /v1/v1-URL erzeugt, die 404 liefert. Feld-Labels und Autofill-Verhalten verschieben sich zwischen Chatbox-Releases leicht, also vertrau der zusammengesetzten URL mehr als dem Gedächtnis. Für Modelle ist Fetch der Weg mit wenig Aufwand: Chatbox listet alles, was der Endpoint bedient, und du schaltest ein, was du willst. New ist der kuratierte Weg: IDs von Hand eintippen, und der Picker bleibt kurz. Jede Modellzeile hat Capability-Schalter (Vision, Tool-Nutzung); lass sie aus, sofern du nicht weißt, dass das Modell die Capability unterstützt, denn ein nicht konfiguriertes Modell wird als reiner Text behandelt, und das ist der sichere Standard. Schließe mit Check ab, starte dann eine Konversation und wähle ein Modell unter deinem neuen Provider-Namen.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (autofilled)

Models: Fetch (pull the catalog) or New (type ids)
Then:   Check → green confirmation

Modellauswahl für einen täglichen Chat-Client.

Da jedes aktivierte Modell über einen Key abrechnet, ist der Vergleich zweier IDs ein Picker-Wechsel statt eine Konto-Entscheidung. Lass dieselbe Art Konversation ein paar Tage auf beiden laufen, lies dann die Ausgaben pro Modell in der APIsRouter-Konsole und behalte, was sich seinen Platz verdient hat.

  • Alltagsfragen und schnelle Umformulierungen sind Burst-Arbeit. claude-haiku-4-5-20251001 und gemini-3.5-flash antworten schnell genug, dass sich die App sofort anfühlt, und tragen den Großteil des Alltags-Traffics gut.
  • Lange Textentwürfe, sorgfältiges Reasoning und Code-Diskussionen verdienen claude-sonnet-4-6 oder gpt-5.5. Halte je eine Stufe aktiviert und wechsle pro Konversation statt pro Provider.
  • deepseek-v4-flash ist die Volumen-Wahl, wenn Chatbox deine ständig offene Sidebar ist; konstante kleine Konversationen summieren sich, und die schnelle Stufe hält das Guthaben langsam sinkend.
  • Konversationen mit Bild-Eingabe brauchen eine vision-fähige ID mit aktiviertem Vision-Schalter auf dieser Modellzeile; bestätige die Capability anhand der Modell-Dokumentation, bevor du den Schalter umlegst.
  • Aktiviere wenige Modelle bewusst, statt alles zu fetchen: jeder Schalter ist eine Picker-Zeile, und eine weitere ID später hinzuzufügen ist eine Zehn-Sekunden-Änderung.

Nutzungsbasiert · unter offiziellem Preis

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

ModellOffizieller PreisUnser Preis
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M
Claude Haiku 4.5 20251001$1.00 / $5.00 per M$0.80 / $4.00 per M
GPT-5.5$5.00 / $30.00 per M$4.00 / $24.00 per M
Gemini 3.5 Flash$1.50 / $9.00 per M$1.20 / $7.20 per M
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M

Fehlerbilder speziell für Chatbox.

Der verdoppelte Pfad ist der Klassiker. Ein 404 bei jeder Nachricht bedeutet, dass API Host und API Path beide ein /v1 tragen oder der Path wiederholt, womit der Host schon endet; öffne den Provider-Eintrag und lies die beiden Felder als eine URL. Ein leeres Ergebnis von Fetch bedeutet meist, dass der Key falsch oder fehlt, da die Modell-Liste selbst eine authentifizierte Anfrage ist. Prüfe das API-Key-Feld und nutze den Check-Button, der Authentifizierungsfehler direkt anzeigt. Ein Modell, das nur in manchen Konversationen Fehler wirft, ist meist ein Capability-Schalter: Vision aktiviert auf einem Modell ohne Bild-Eingabe, oder ein Tool-abhängiger Flow, der auf ein Modell mit ausgeschalteten Tools trifft. Setze die Modellzeile auf Standard zurück und aktiviere Capabilities einzeln neu. Und denk daran: Der Provider-Eintrag gilt pro Installation. APIsRouter auf deinem Desktop hinzuzufügen konfiguriert dein Handy nicht; wiederhole den Dialog dort, oder nutze Chatboxs eigenes Config-Sharing, falls deine Version das anbietet. Das Einzige, was sich nie wiederholen muss, sind Vendor-Anmeldungen, da ein Key jedes Modell auf jedem Gerät abdeckt.

Wer Chatbox über ein Gateway leitet.

  • Leute, die Claude, GPT, Gemini und DeepSeek in einem Picker wollen, ohne vier Vendor-Konten und vier Keys über drei Geräte zu verwalten.
  • Nutzer in Regionen, wo manche Vendor-Anmeldungen mühsam sind; Zugang auf Guthabenbasis ohne Kartenpflicht entfernt die Abhängigkeit pro Provider.
  • Entwickler, die ihren Editor und ihre Terminal-Tools bereits über ein Gateway leiten und ihren Chat-Client auf demselben Key und Nutzungslog wollen.
  • Modell-Shopper, die IDs an echten Konversationen vergleichen, bevor sie ein Projekt festlegen; jeder Kandidat ist eine Picker-Zeile, kein Konto.
  • Haushalte und kleine Teams, die auf einen Endpoint, ein Guthaben und Nutzungs-Sichtbarkeit pro Key statt verstreute Abos standardisieren.

Endpoint prüfen und die erste Nachricht debuggen.

Beweise die Gateway-Hälfte zuerst außerhalb von Chatbox: Modelle mit deinem Key listen, dann eine Chat-Completion gegen eine ID ausführen, die du aktivieren willst. Bestehen beide, liegt alles Übrige im Provider-Dialog. In Chatbox ist der Check-Button das schnellste Signal. Authentifizierungsfehler sind das Key-Feld. Not-Found-Fehler beim Senden sind ein ID-Mismatch, was meist bei handgetippten New-Einträgen passiert; kopiere IDs aus der /v1/models-Ausgabe statt aus dem Gedächtnis. 404er bei jeder Anfrage sind die oben beschriebene Host/Path-Zusammensetzung. Sobald Nachrichten laufen, zeigt die APIsRouter-Konsole Modell, Token-Zahlen und Ausgaben pro Anfrage. Ein Chat-Client erzeugt viele kleine Anfragen über den Tag, und das Nutzungslog macht daraus eine lesbare Zahl pro Modell, pro Tag.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Häufige Fragen

Wie füge ich Chatbox einen Custom API Host hinzu?

Settings, Tab Model Provider, Add, dann Add Custom Provider. API Mode auf OpenAI API Compatible setzen, API Host auf https://api.apisrouter.com/v1, Key einfügen und API Path auf dem /chat/completions-Standard lassen. Modelle mit Fetch oder New hinzufügen, dann Check drücken.

Sollte der API Host /v1 enthalten?

Beide Formen funktionieren, solange Host und Path sich exakt einmal zu /v1/chat/completions zusammensetzen. Mit Host https://api.apisrouter.com/v1 ist der Path /chat/completions; bei einem Bare-Host ist der Path standardmäßig /v1/chat/completions. Beide zu mischen verdoppelt das /v1 und liefert 404.

Kann Chatbox Claude, Gemini und DeepSeek über einen Provider-Eintrag betreiben?

Ja. Im Modus OpenAI API Compatible reist die Modell-ID als reiner String zum API Host, sodass ein Eintrag claude-sonnet-4-6, gemini-3.5-flash und deepseek-v4-flash zusammen aktivieren kann, alle über denselben Key abgerechnet und im Picker umschaltbar.

Warum liefert Fetch keine Modelle zurück?

Fetch ruft die /v1/models-Liste des Endpoints mit deinem Key auf, also ist ein leeres Ergebnis fast immer ein Authentifizierungsproblem. Prüfe das API-Key-Feld erneut und drücke Check; sobald der Key durchgeht, listet Fetch jede ID, die das Gateway bedient.

Funktioniert der Custom Provider auch auf Chatbox Mobile und Web?

Ja, der Add-Custom-Provider-Dialog läuft in Desktop-, Mobile- und Web-Builds. Provider-Einträge werden pro Installation konfiguriert, also wiederhole das Ein-Dialog-Setup auf jedem Gerät mit demselben Key.

Brauche ich Capability-Schalter für jedes Modell?

Nein. Ein nicht konfiguriertes Modell funktioniert als reiner Text-Chat, was der sichere Standard ist. Aktiviere Vision- oder Tool-Schalter nur bei Modellen, die die Capability tatsächlich unterstützen, da ein falsch aktivierter Schalter genau in den Konversationen verwirrende Fehler erzeugt, die ihn nutzen.