AI Image Generation

AI Image Generation

Chatlix kann auf Knopfdruck Bilder mit gpt-image-1 (OpenAI) generieren. Das ist klassisch als Reward-Reaktion gedacht: Zuschauer löst einen Twitch-Reward ein → Chatlix generiert ein Bild aus dem Prompt → Overlay zeigt es kurz an.

Kosten

15 Credits pro Bild (gpt-image-1, 1024×1024). Belastet wird nach erfolgreichem Provider-Call. Bei Provider-Fehlern (ok:false) fällt keine Buchung an.

Manuelle Generierung im Dashboard

Dashboard → AI-Builder → Tab « Bild ».

1. Prompt eingeben (z. B. Pixel-Art-Drache mit Twitch-Logo).
2. « Generieren ». Wartezeit typischerweise 5–15 Sekunden.
3. Ergebnis wird angezeigt. Buttons: « Speichern » (legt es im Media-Bereich ab), « Im Overlay zeigen » (Test-Push an deine aktive Overlay-Browserquelle), « Verwerfen ».

Gespeicherte Bilder landen im normalen Media-Storage und können wie jede andere Datei in Overlays, Alerts oder Stream-Memory verwendet werden.

Als Reward-Reaktion (Twitch)

Das typische Setup:

1. Twitch-Reward anlegen oder existierenden auswählen (Dashboard → Twitch → Rewards).
2. Automation-Regel: Trigger = twitch.reward.redeemed, Filter = dein Reward.
3. Aktion = « AI-Bild generieren ».
4. Prompt-Template: z. B. {user_input_or_user_message}. Der Zuschauer-Text aus dem Reward landet als Prompt.
5. Aktion = « Overlay zeigen ». Eingabe = generiertes Bild. Anzeigedauer z. B. 8 Sekunden.

Wichtig: setze einen Cost auf den Reward, der mindestens den Credit-Wert deckt. 15 Credits müssen für dich wirtschaftlich passen, sonst nutzt jemand das als Spam-Reward.

Prompt-Hygiene

• Kürze hilft. Modelle sind besser im verstehen kurzer, klarer Prompts als langer Beschreibungen.
• Stil-Hinweis voranstellen: Anime-Stil, ... oder Foto-realistisch, ....
• Negativ-Prompts werden von gpt-image-1 nicht unterstützt — anders als bei Stable-Diffusion. Stattdessen positiv formulieren.

Inhaltliche Filter

Provider-seitig läuft eine Content-Policy. Verstoßende Prompts kommen mit:

{"ok": false, "error": "content_policy_violation"}

zurück, ohne Credit-Abzug. Wenn dein Channel ein Publikum hat, das gern an die Grenzen geht: du kannst die Reward-Aktion mit einer Pre-Filter-Liste kombinieren (Dashboard → Automation → Filter „Wort-Blocklist“), um offensichtliche Trigger-Wörter abzufangen, bevor sie überhaupt OpenAI sehen.

Stub-Modus für Tests

Wenn du eine Reward-Regel testen willst, ohne echte Bilder zu generieren: Stub-Modus aktivieren (interne Konfiguration). Der Endpoint liefert dann ein deterministisches Test-Bild zurück, ohne OpenAI zu kontaktieren und ohne Credits zu buchen. Praktisch um Overlay-Layout, Alert-Sound, Timing zu testen.

Was passiert wenn OpenAI down ist

• Endpoint liefert HTTP 200 + ok:false + error=provider_unavailable.
• Keine Credit-Buchung.
• Reward bleibt in Twitch als „eingelöst“ — du kannst ihn manuell refunden oder die Automation-Regel um eine Fallback-Aktion ergänzen (z. B. „statt Bild eine Text-Antwort posten“).

Bekannte Grenzen

• Bilder werden nicht „verbessert“ wenn du sie nochmal generierst — gpt-image-1 ist nicht deterministisch.
• Keine Bild-zu-Bild-Funktion in Chatlix (Stand 2026-05). Nur Text-zu-Bild.
• Maximale Anzeige-Dauer im Overlay ist nicht limitiert, aber lange Anzeigen blockieren weitere Alert-Bilder. Empfehlung: 6–10 Sekunden.
• Bilder werden im Media-Storage gespeichert und zählen gegen das Speicher-Kontingent deines Plans.

AI-Bild-Action intern

Für Entwickler: die Action lebt unter /v1/ai/ als Endpoint, der Code liegt in Chatlix\Service\Ai. Die Action ist additiv zu MediaService (für Storage) und Alert-Pipeline (für Overlay-Push) — sie ersetzt nichts, sondern hängt sich davor.