Direkt zum Hauptinhalt

AI Features Ueberblick

AI Features Überblick

Chatlix bündelt mehrere AI-gestützte Funktionen (Text-to-Speech, AI-Bildgenerierung, AI-Builder, Sprite Studio, Stream-Memory-AI) hinter einem einheitlichen Credits-System. Du gibst Credits aus, Chatlix kümmert sich um Provider-Keys, Rate-Limits und Abrechnung.

Was steckt drin

  • TTS (Text-to-Speech) über ElevenLabs. Nutzbar in Automation-Regeln (Aktion speak_text), im Audio Studio als eigenständige Generierung, oder als Preview im Dashboard. Details: siehe Seite TTS einrichten.
  • AI-Bildgenerierung über gpt-image-1 (OpenAI). Nutzbar als Reward-Aktion (Twitch-Reward → AI-Bild im Overlay), manuell im Pack-Editor/Mediathek oder aus dem Dashboard. Details: siehe Seite AI Image Generation.
  • Audio Studio (Dashboard /dashboard/audio-studio): Mic-Effekte, Limiter und Sound-Effekt-Generierung (SFX) über den ElevenLabs Sound-Effects-Endpoint. Läuft technisch über denselben AudioGenerationService wie TTS, hat aber eigene Action-Keys (ai.sfx / ai.sfx_test) und einen eigenen Prompt-Längen-Cap von 1000 Zeichen.
  • Sprite Studio (Dashboard /dashboard/sprite-studio, im Sidebar-Menü unter „Power"-Rubrik einsortiert — das ist eine reine UI-Gruppierung, kein Plan-Gate: die Backend-Routen prüfen nur Session/CSRF, keinen Plan): KI-generierte Grafiken/Sprites inkl. Animation, technisch an Ludo angebunden. Basis-Generierung kostet 20 Credits, Animation-Add-on 15 Credits (ai.sprite.generate / ai.sprite.animate). Eigene Rate-Limits über SpriteStudioRateLimiter. Diese Seite hier behandelt Sprite Studio nicht im Detail — bei Bedarf eigene Wiki-Seite anlegen.
  • AI-Builder (Dashboard /dashboard/ai-builder, erfordert einen bezahlten Plan ab Starter aufwärts — nicht speziell "Pro") zum Generieren/Anpassen von Overlays und Automation-Regeln aus natürlicher Sprache.
  • Stream-Memory-AI: Sub-Endpoints unter /v1/stream-memory/* für kontextbezogene Auswertung (Recap/Highlights via ai.stream.summarize, Transkription längenbasiert nach Audio-Minuten, Kandidaten-Ranking via ai.stream.candidates_rank).
  • Clip Publishing Assistant: generiert pro Plattform (TikTok, YouTube Shorts, Instagram Reels, Facebook Reels, X) ein Titel-/Caption-/Hashtag-Paket. Einzelpreise 3–6 Credits, Bundle für alle 5 Plattformen 19 Credits (statt 23 einzeln).
  • Voices: Stimm-Verwaltung für TTS unter /dashboard/voices.

Wo finde ich was im Dashboard

BereichDashboard-RouteAufgabe
Voices/dashboard/voicesTTS-Stimmen verwalten, Test-Sample anhören, BYO-ElevenLabs-Key hinterlegen
Audio Studio/dashboard/audio-studioTTS/SFX manuell generieren, Mic-Effekte, Limiter
Sprite Studio/dashboard/sprite-studioKI-Grafiken/Sprites generieren und animieren
AI-Builder/dashboard/ai-builderRegeln/Overlays aus Text generieren lassen (ab Starter)
AI-Credits/dashboard/ai-creditsKontingent prüfen, Credits nachkaufen, Transaktions-Log

Credits-System

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

  1. Plan-Kontingent — wird monatlich automatisch aufgeladen. Aktueller Stand (Pricing 2026-Q3, Quelle AiCreditsService::PLAN_MONTHLY_ALLOWANCE):
    • Free: 40 Credits/Monat
    • Starter: 90 Credits/Monat
    • Creator: 450 Credits/Monat
    • Pro Max: 1.400 Credits/Monat
    • Team: 4.500 Credits/Monat
    Legacy-Pläne (Pro/Studio/Elite aus der alten Preisstruktur) sind grandfathered und behalten ihre alten Werte über einen separaten Backfill-Pfad.
  2. Zukauf — zusätzliche Credit-Pakete, die nicht ablaufen solange dein Account aktiv ist. Aktuelle Pakete:
    • Starter-Pack: 500 Credits für 2,99 €
    • Creator-Pack: 2.000 Credits für 9,99 €
    • Chaos-Goblin-Pack: 5.000 Credits für 19,99 €
    • Stream-Monster-Pack: 15.000 Credits für 49,99 €

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. Faustregel aus dem Code: 1 Credit ≈ 0,005 € — das ist eine grobe Kalkulationsgröße, keine exakte Umrechnung, weil verschiedene Provider unterschiedlich bepreist werden.

Beispiel-Kosten (Stand 2026-Q3, Quelle AiCreditsService::COST_MULTIPLIER)

  • AI-Bild (gpt-image-1): gestaffelt nach Qualität/Größe — 8 Credits (low, 1024er), 15 Credits (medium, 1024er, Default), 20 Credits (high oder jede 1536er-Größe, unabhängig von der angefragten Qualität). Details siehe Seite AI Image Generation.
  • TTS (ElevenLabs, Automation-Aktion speak_text oder Audio-Studio-Generierung): flacher Preis von 5 Credits pro Call, unabhängig von der Textlänge (innerhalb der jeweiligen Zeichen-Obergrenze). TTS-Preview im Dashboard: 1 Credit. Wichtig: Das ist kein Preis-pro-Zeichen-Modell mehr — Details und Ausnahmen (Premium-Stimmen-Multiplikator) siehe Seite TTS einrichten.
  • SFX-Generierung (Audio Studio): 5 Credits, Preview 1 Credit.
  • Sprite-Generierung: 20 Credits Basis, +15 Credits für Animation.
  • AI-Automation-Vorschlag / Overlay-Vorschlag: je 3 Credits pro Call.
  • Stream-Recap/Highlights: 8 Credits pro Session-Analyse.

Eigener ElevenLabs-Key (BYO)

Für TTS/SFX kannst du statt des von Chatlix bereitgestellten Zugangs (chatlix_key, intern shared_demo) deinen eigenen ElevenLabs-API-Key hinterlegen (byo_key, intern user_key). Läuft eine Operation über deinen eigenen Key, verbraucht sie keine Chatlix-Credits — du wirst direkt und ausschließlich von ElevenLabs abgerechnet. Fehlt bei aktiviertem BYO-Modus der Key, wird die Operation blockiert (byo_key_missing), es gibt keinen automatischen Fallback auf den Chatlix-Key.

Kostenlose Kontingente ohne Credit-Verbrauch

  • Korrektur: Das kostenlose Tageskontingent für AI-Bilder (UTC-Tagesgrenze, Zähler in Redis chatlix:freelimit:ai_image:*, Key PlanService::LIMITS[...]['ai_images_per_day']) ist im Code aktuell nur für den Starter-Plan mit 1 Bild/Tag hinterlegt — nicht für den Free-Plan. Free-Plan sowie Creator/Pro Max/Team haben dort den Wert 0, d. h. der Mechanismus greift für sie gar nicht: jedes AI-Bild kostet dort ganz normal Credits aus der Staffel (siehe oben), es gibt kein separates Gratis-Kontingent obendrauf.
  • Test-Sample einer Voice im Dashboard ist kostenlos (gecachtes Demo-Sample).
  • Fehlgeschlagene Operationen (ok:false nach Provider-Fehler) werden automatisch refunded, nicht nur „nicht belastet" — der Code zieht die Credits vorab ab und bucht sie bei Fehlschlag wieder zurück (Ledger-Eintrag *_provider_failed bzw. *_failed_refund).
  • Stub-Modus (interner Test-Provider, kein echter API-Call) bucht 0 Credits.

Fehler-Verhalten

Achtung, das Verhalten unterscheidet sich je nach Feature — hier war die alte Doku zu pauschal:

  • AI-Bild, /v1/creator/ai-image/generate): fachliche Fehler wie provider_failed (Content-Policy-Ablehnungen laufen ebenfalls darüber, im detail-Feld), cooldown_active, free_ai_daily_limit kommen als HTTP 200 mit {"ok": false, "error"/"code": "..."} zurück — bewusst kein 4xx/5xx, damit ein automatischer Retry (z. B. im Worker) nicht denselben kostenpflichtigen Provider-Call mehrfach auslöst. Einzige Ausnahme: insufficient_credits liefert HTTP 402.
  • TTS/SFX (Audio Studio, speak_text-Aktion): hier werden reale HTTP-Statuscodes verwendet — 400 für text_too_long/prompt_too_long, 429 für Rate-Limit-/Kontingent-Grenzen (audio_limit_reached), 402 für Credit-Themen. Ein Client muss hier also den Statuscode auswerten, nicht nur das ok-Feld.

Typische fachliche Fehlercodes über beide Features hinweg:

  • text_too_long / prompt_too_long — Zeichen-Limit überschritten (siehe jeweilige Detailseite für die genauen Zahlen).
  • insufficient_credits — Kontingent leer.
  • provider_failed — OpenAI / ElevenLabs antworten nicht oder liefern einen Fehler (bei AI-Bild inkl. provider-seitig abgelehnter Prompts — kein eigener Fehlercode dafür, steckt im detail-Feld).
  • cooldown_active — Anti-Spam-Cooldown greift (z. B. 5 Sekunden pro User bei AI-Bild).

Nächste Schritte

  • Stimmen einrichten, Kosten und Limits im Detail verstehen → Seite TTS einrichten.
  • Bilder als Reward-Reaktion verwenden, Qualitäts-/Größen-Staffel verstehen → Seite AI Image Generation.
  • Automation-Regel aus Text generieren → Dashboard /dashboard/ai-builder (bezahlter Plan ab Starter erforderlich), Eingabe in natürlicher Sprache, Vorschlag prüfen, übernehmen.
  • Guthaben/Verbrauch im Blick behalten → Dashboard /dashboard/ai-credits, dort auch das Transaktions-Log pro Operation.