# Chatbox mit OpenCheese

> Füge OpenCheese in Chatbox auf Smartphone oder Desktop hinzu: OpenAI-API-kompatibler Anbieter, API-Host und -Pfad, API-Schlüssel, Modelle und Verbindungstest.
>
> Webseite: https://opencheese.dev/de/docs/chatbox/ · Alle Seiten der Doku: https://opencheese.dev/de/docs.md

[Chatbox](https://chatboxai.app) 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`) |

5. Füge mindestens ein Modell hinzu: Ruf die Liste ab oder gib eine Modell-ID aus
   [`/v1/models`](https://opencheese.dev/de/docs/models.md) 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.
6. 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](https://opencheese.dev/de/docs/images.md) 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`.