# AI Features Ueberblick

# AI Features Überblick

Chatlix bündelt die AI-Features (Text-to-Speech, AI-Bildgenerierung, AI-Builder für Automation-Regeln) hinter einem einheitlichen Credits-System. Du musst dich also nicht um Provider-Keys, Rate-Limits oder unterschiedliche Abrechnungsmodelle kümmern — du gibst Credits aus, Chatlix kümmert sich um den Rest.

## Was steckt drin

- **TTS (Text-to-Speech)** über ElevenLabs. Nutzbar in Alerts, Overlays, Reward-Reaktionen, Sound-Schnipseln im Stream-Memory.
- **AI-Bildgenerierung** über `gpt-image-1` (OpenAI). Nutzbar als Reward-Aktion (Twitch-Reward → AI-Bild im Overlay) oder manuell aus dem Dashboard.
- **AI-Builder** zum Generieren / Anpassen von Automation-Regeln aus natürlicher Sprache.
- **Stream-Memory-AI**: Sub-Endpoints unter `/v1/stream-memory/*/ai` für kontextbezogene Auswertung (z. B. Highlight-Vorschläge, Clip-Captions).
- **Voices**: Stimm-Auswahl für TTS unter `/v1/voices/`.

## Wo finde ich was im Dashboard

| Bereich | Dashboard-Route | Aufgabe |
|---|---|---|
| AI-Builder | `/dashboard/ai-builder` | Regeln aus Text generieren lassen |
| AI-Credits | `/dashboard/ai-credits` | Kontingent prüfen, Credits nachkaufen, Transaktions-Log |
| Voices | `/dashboard/voices` | TTS-Stimmen verwalten, Test-Sample anhören |

## Credits-System

Jede AI-Operation kostet Credits. Es gibt zwei Quellen:

1. **Plan-Kontingent** — wird monatlich automatisch aufgeladen. Die Höhe hängt vom gebuchten Plan ab.
2. **Zukauf** — du kannst zusätzliche Credits separat erwerben. Die laufen nicht ab, solange dein Account aktiv ist.

Wichtig: Plan-Credits werden zuerst verbraucht, Zukauf-Credits erst wenn das Monats-Kontingent leer ist. Beim Monatswechsel verfällt nicht verbrauchtes Plan-Kontingent, Zukauf-Credits bleiben.

### Beispiel-Kosten (Stand 2026-05)

- **AI-Bild** (`gpt-image-1`, 1024×1024): **15 Credits pro Bild**.
- **TTS** (ElevenLabs): Credits pro Zeichen — je nach gewählter Voice. Genauer Tarif steht im AI-Credits-Dashboard direkt neben jeder Stimme.

## Stub-Modus für Tests

Für Entwicklung und Tests gibt es einen Stub-Modus: Operationen laufen durch, ohne den echten Provider zu kontaktieren. Das spart Credits und macht E2E-Tests deterministisch. Stub-Modus wird serverseitig per Feature-Flag aktiviert — relevant primär für interne Tests.

## Fehler-Verhalten

Fachliche / providerseitige Fehler liefern bewusst `HTTP 200` mit `{"ok": false, "error": "..."}` — **nicht** `4xx`/`5xx`. Hintergrund: Ein 5xx würde den apiFetch-Retry triggern und im Worst-Case dreimal denselben kostenpflichtigen Provider-Call auslösen. Beispiele:

- `text_too_long` — TTS-Text überschreitet das Limit (siehe TTS-Seite).
- `insufficient_credits` — Kontingent leer.
- `provider_unavailable` — OpenAI / ElevenLabs antworten nicht.
- `content_policy_violation` — Prompt wurde provider-seitig abgelehnt.

Nur echte HTTP-Fehler (Netzwerk, Auth, Rate-Limit auf API-Ebene) kommen als 4xx/5xx zurück.

## Was kostet was nicht

- **Test-Sample** einer Voice im Dashboard ist kostenlos (cachet einen festen Demo-Satz).
- **Failed Operations** mit `ok:false` werden **nicht** belastet.
- **Stub-Modus** schreibt keine Credit-Buchung.

## Nächste Schritte

- Stimmen einrichten → siehe Seite *TTS einrichten*.
- Bilder als Reward-Reaktion verwenden → siehe Seite *AI Image Generation*.
- Automation-Regel aus Text generieren → Dashboard `/dashboard/ai-builder`, Eingabe in natürlicher Sprache, Vorschlag prüfen, übernehmen.