Zum Hauptinhalt springen

Chatbox mit OpenCheese

/ API-Doku

← API-SchnellstartAls Markdown anzeigen

Chatbox läuft auf Android, iOS, Windows, macOS und Linux und bindet OpenCheese als benutzerdefinierten Anbieter im OpenAI-Format ein. Die Einrichtung ist in jeder Version gleich.

Den Anbieter hinzufügen

  1. Öffne in der Seitenleiste Einstellungen (Settings), dann Modellanbieter (Model Provider).
  2. Klicke unten in der Anbieterliste auf Hinzufügen (Add).
  3. Gib ihm einen Namen (zum Beispiel OpenCheese) und wähle als API-Modus OpenAI API kompatibel (OpenAI API Compatible).
  4. Fülle die Felder aus:
Feld Wert
API Key dein OpenCheese-API-Schlüssel
API Host https://api.opencheese.dev/v1
API Pfad (API Path) leer (Chatbox nutzt /chat/completions)
  1. Füge mindestens ein Modell hinzu: Ruf die Liste ab oder gib eine Modell-ID aus /v1/models ein. Markiere die Fähigkeiten des Modells, etwa Vision oder Tool-Nutzung (Tool use), passend zu seinen modalities und capabilities; ein Modell ohne sie wird als reines Textmodell behandelt.
  2. Speichere und klicke auf Prüfen (Check): Die Prüfung sollte eine erfolgreiche Verbindung melden.

Bleibt der Pfad leer, ergänzt Chatbox /v1, wenn der Host keins enthält; deshalb funktioniert auch https://api.opencheese.dev.

Verwendung

Starte eine neue Unterhaltung und wähle in der Modellauswahl ein OpenCheese-Modell. Für Bilder nutze ein Bildmodell über die Bild-API oder KI-Bilder im Dashboard.

Verbrauch

Jede Anfrage erscheint im Dashboard unter Transaktionen. Chatbox teilt dem Gateway nicht mit, zu welcher Unterhaltung eine Anfrage gehört, daher wird vorerst jede Anfrage als eigene Sitzung angezeigt.

Fehlerbehebung

Um die App als Ursache auszuschließen, prüfe den Schlüssel und die Modell-IDs von einem Computer aus:

bash
curl -s https://api.opencheese.dev/v1/models \
  -H "Authorization: Bearer $OPENCHEESE_API_KEY" | jq -r '.data[].id'
  • „Invalid or disabled OpenCheese API key“: Der Schlüssel wurde unvollständig kopiert oder auf der Seite API-Schlüssel deaktiviert.
  • Das Modell wird nicht gefunden: Modell-IDs müssen exakt stimmen; kopiere sie aus /v1/models.
  • Statt der API antwortet die Website: Der Host muss api.opencheese.dev sein, nicht opencheese.dev.
Der Käse hat Löcher. Deine Infrastruktur sollte keine haben.