Anwendungsfall

KI-Moderation für den Twitch-Chat, die die Regeln deines Kanals kennt

Ein voller Twitch-Chat ist schneller, als jeder Moderator lesen kann. VigiMod prüft jede Nachricht zusammen mit den vorherigen, in 26 Sprachen, und nach den Regeln deines Kanals: Dein Bot löscht, was dagegen verstößt, und lässt die Witze stehen.

Kostenlosen API-Schlüssel holenDokumentation lesen

Was es schwierig macht

Schnell und voller Insider

Emotes, Copypasta und Sticheleien unter Stammzuschauern wirken ohne Kontext wie Beleidigungen. Die vorherigen Nachrichten mitzulesen vermeidet die meisten Fehlmarkierungen.

Regeln, die kein Filter kennt

„Keine Spoiler zum Spiel“, „Kein Backseating“, „Keine Eigenwerbung“: Jeder Kanal hat eigene Regeln, und Wortlisten erkennen sie nicht.

Zuschauer aus aller Welt

Große Streams bekommen Chat in vielen Sprachen, und Wortlisten müssen für jede neu geschrieben werden. VigiMod wurde mit 26 Sprachen trainiert.

So funktioniert es mit VigiMod

  1. 1

    Dein Bot liest den Chat (IRC oder EventSub) und behält die letzten zehn Nachrichten.

  2. 2

    Jede neue Nachricht geht mit diesem Kontext, der ID des Autors und den Kanalregeln an VigiMod.

  3. 3

    Ist die Antwort markiert, löscht der Bot die Nachricht über die Twitch-API oder gibt dem Nutzer nach mehreren Markierungen einen Timeout.

Regeln zum Kopieren

Sende sie im Feld rules: Jede kommt mit einer eigenen Bewertung zurück, wie eine eingebaute Kategorie.

{
  "rules": {
    "no-spoilers": "Keine Spoiler zum aktuell gespielten Spiel",
    "no-backseating": "Dem Streamer nicht sagen, wie er spielen soll, wenn er nicht fragt",
    "no-self-promo": "Keine Werbung für den eigenen Kanal oder die eigenen Socials",
    "german-only": "Im Chat nur Deutsch"
  }
}

Beispiel

Ein Node.js-Bot: tmi.js liest den Chat, VigiMod prüft jede Nachricht, die Twitch-API löscht sie bei einer Markierung (der Token braucht den Scope moderator:manage:chat_messages).

JavaScript (Node.js)

// npm install tmi.js  (Node 18+)
// tmi.js reads the chat; the Twitch API deletes a message (token scope: moderator:manage:chat_messages)
import tmi from "tmi.js";

const { VIGIMOD_KEY, TWITCH_TOKEN, TWITCH_CLIENT_ID, BROADCASTER_ID, MODERATOR_ID } = process.env;
const RULES = { "no-spoilers": "No spoilers about the game being played" };
const recent = [];                       // the last messages of the chat, sent as context

const client = new tmi.Client({ channels: ["your_channel"] });

client.on("message", async (channel, tags, text, self) => {
  if (self) return;
  const res = await fetch("https://api.vigimod.com/moderate", {
    method: "POST",
    headers: { "X-API-Key": VIGIMOD_KEY, "Content-Type": "application/json" },
    body: JSON.stringify({
      text: text.slice(0, 2000), context: [...recent], rules: RULES,
      user_id: tags["user-id"], scope: channel,
    }),
    signal: AbortSignal.timeout(2000),
  }).catch(() => null);                  // slow or down: let the message through
  recent.push(text.slice(0, 2000));
  if (recent.length > 10) recent.shift();
  if (!res?.ok) return;

  const result = await res.json();
  if (result.flagged) {
    const q = new URLSearchParams({ broadcaster_id: BROADCASTER_ID, moderator_id: MODERATOR_ID, message_id: tags.id });
    await fetch(`https://api.twitch.tv/helix/moderation/chat?${q}`, {
      method: "DELETE",
      headers: { Authorization: `Bearer ${TWITCH_TOKEN}`, "Client-Id": TWITCH_CLIENT_ID },
    });
  }
});

client.connect();

Tipps

  • Lass AutoMod an: Es hält Nachrichten zurück, bevor sie erscheinen; VigiMod ergänzt danach deine Regeln, den Kontext und weitere Sprachen.
  • Lösche bei einer Markierung, aber gib einen Timeout erst nach mehreren Markierungen desselben Nutzers in kurzer Zeit.
  • Sende user_id und den Kanal als scope: Wiederholte Nachrichten und Flood eines Nutzers erhöhen den Spam-Wert.

Fragen

Ersetzt VigiMod Twitch AutoMod?
Nein, es arbeitet zusammen damit. AutoMod ist in Twitch eingebaut und hält Nachrichten vor der Anzeige zurück; VigiMod prüft deine eigenen Regeln, liest den Kontext und deckt 26 Sprachen ab.
Ist es schnell genug für Live-Chat?
Jede Nachricht ist ein HTTP-Aufruf. Gib ihm einen kurzen Timeout (etwa zwei Sekunden) und lass die Nachricht durch, wenn ein Aufruf fehlschlägt oder zu lange dauert, damit der Chat weiterläuft.
Was ist mit sehr vollen Kanälen?
Die kostenlose Beta erlaubt 120 Nachrichten pro Minute und API-Schlüssel. Ist dein Chat schneller, schreib dem Support dein Volumen, dann kann das Limit erhöht werden.
Kann ich es für VODs oder Clips nutzen?
VigiMod prüft nur Text. Du kannst Titel, Chat-Wiederholungen und Kommentare prüfen, aber nicht Video oder Audio.

Weitere Anwendungsfälle

Weiterlernen

Alle Leitfäden

Anwendungsfälle

Du kommst von einer anderen API?

Teste es in deiner Community

Erstelle in zwei Minuten einen kostenlosen API-Schlüssel. Keine Karte, keine Testphase.

Kostenlosen API-Schlüssel holenDokumentation lesen