Was ist der Grok API guidelines-Parameter? Benutzerdefinierte Inhaltsmoderation, erklärt

xAI hat der Grok Text-API einen guidelines-Parameter hinzugefügt, mit dem Sie dem Modell mitteilen können, bestimmte Inhaltskategorien beim Schreiben stärker zu moderieren. Wenn Sie auf Grok aufbauen und eine engere Kontrolle über sensible Ausgaben benötigen, ist dies die erste anfrageinterne Inhaltssteuerung, die xAI für Text bereitstellt. Hier erfahren Sie genau, was der Grok API guidelines-Parameter bewirkt, welche Kategorien er abdeckt, wie Sie ihn setzen und welche Anfragelimits und Fehler Sie einplanen sollten.

Was der guidelines-Parameter bewirkt

Der guidelines-Parameter ist ein Array, das Sie einer Grok Text-API-Anfrage hinzufügen, um zu ändern, wie das Modell bestimmte Inhaltskategorien behandelt. Für jede aufgeführte Kategorie wählen Sie ein erweitertes Verhalten; Grok befolgt die Guidelines dann beim Schreiben seiner Antwort in eigenen Worten. Die Antwort hat dieselbe Form wie eine normale Antwort — es gibt keinen zusätzlichen Wrapper zum Parsen.

Zwei Dinge sind hier wichtig:

• Es ist opt-in pro Kategorie. Jede Kategorie, die Sie weglassen, behält das Standard-Moderationsverhalten des Modells bei, sodass Sie nur die Kategorien auflisten, die Sie tatsächlich ändern möchten.
• Es gilt pro Anfrage. Guidelines gelten nur für die Anfrage, die sie enthält. Um ein gesamtes Gespräch abzudecken, senden Sie sie bei jeder Anfrage in diesem Gespräch mit.

Die Funktion wurde in den Grok API Release Notes im Oktober dokumentiert und ist laut xAIs Ankündigung für alle API-Kunden verfügbar.

Welche Kategorien und Verhaltensweisen unterstützt werden

Jeder Eintrag in guidelines hat drei Felder: type (immer "policy"), eine category und das gewünschte behavior. Derzeit ist das einzige Verhalten decline.

Die Dokumentation beschreibt diese Verhaltensweisen auf hohem Niveau und weist darauf hin, dass xAI die Details im Laufe der Zeit verfeinern kann. Die praktische Schlussfolgerung: decline ist eine sanftere Steuerung innerhalb der Antwort, kein harter Klassifikator, der einen Fehler zurückgibt — Grok gestaltet seine eigene Antwort um, um innerhalb der genannten Kategorie zu bleiben.

So setzen Sie guidelines in einer Anfrage

Sie übergeben guidelines als Array auf oberster Ebene. In der Responses API steht es neben Ihren anderen Parametern; in Chat Completions befindet es sich auf derselben Ebene wie messages. Hier ist eine Anfrage, die sowohl violence als auch nsfw auf decline setzt:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Write a short story about a knight.",
    "guidelines": [
      { "type": "policy", "category": "violence", "behavior": "decline" },
      { "type": "policy", "category": "nsfw", "behavior": "decline" }
    ]
  }'

SDK-Hinweise, die häufig zu Problemen führen:

• OpenAI Python SDK: Das Feld ist nicht definiert, daher übergeben Sie es in extra_body.
• OpenAI JavaScript SDK: Senden Sie guidelines zusammen mit Ihren anderen Anfrageparametern.
• xAI Python SDK: chat.create speichert die Guidelines im Chat, sodass jeder sample()-Aufruf sie automatisch sendet — Sie müssen sie nicht selbst wiederholen.

Welche APIs es unterstützen — und welche nicht

guidelines wird in Chat Completions, der Responses API und chat.create im xAI Python SDK akzeptiert. Es funktioniert nicht in einigen Fällen, und die API lehnt diese Anfragen mit einem 400-Fehler ab, bevor das Modell ausgeführt wird:

• Multi-Agenten-Modelle, wie grok-4.20-multi-agent.
• Verzögerte Completions (Deferred Completions).
• Eine Anfrage ohne serverseitige Tools und ohne Dateianhänge, die zusätzlich stop setzt oder n größer als 1 setzt.

Da die Prüfung im Voraus erfolgt, kostet eine abgelehnte Anfrage keine Modellinferenz — aber das bedeutet, dass Sie diese Fehler im Code abfangen müssen.

Zu erwartende Fehler

Die API validiert guidelines vor der Ausführung des Modells und gibt einen Fehler zurück, wenn sie nicht angewendet werden können:

Im xAI Python SDK löst eine unbekannte Kategorie oder ein unbekanntes Verhalten einen ValueError aus, bevor die Anfrage überhaupt gesendet wird; die anderen Fehler kommen als gRPC-Status INVALID_ARGUMENT zurück.

Warum das für Entwickler wichtig ist

Grok wurde historisch als permissiveres Modell positioniert, und Text-API-Aufrufe hatten bisher keine anfrageinternen Moderationssteuerungen — Sie nahmen das Standardverhalten des Modells oder filterten die Ausgabe selbst. Der guidelines-Parameter ist ein Mittelweg: kategoriebasierte Steuerung, die Sie inline deklarieren, ohne separaten Moderationsaufruf und ohne Schwellenwertlogik in Ihrem eigenen Code.

Er ist derzeit bewusst eng gehalten — drei Kategorien, ein Verhalten (decline), nur Text. Für einen kundenseitigen Chatbot, bei dem Sie kein Risiko sexualisierter oder grafisch gewalthaltiger Ausgaben eingehen können, ist die Deklaration von nsfw und violence als decline eine einzeilige Absicherung. Für alles Strengere oder Auditierbarere benötigen Sie weiterhin eigene Ausgabeprüfungen, da decline die Antwort umgestaltet, anstatt sie hart zu blockieren — und Sie sollten die oben genannten 400/422-Ablehnungen weiterhin behandeln.

Moderierte KI-Workflows mit eigenen Agenten erstellen

Inhaltssteuerungen wie Groks guidelines-Parameter sind ein Baustein für den sicheren KI-Betrieb in der Produktion — der schwierigere Teil ist die Verknüpfung der Modellausgabe mit echten Aufgaben, Genehmigungen und Tools. Eigent ist eine Open-Source-Multi-Agenten-„Cowork"-App, die eine KI-Belegschaft lokal ausführt, sodass Sie sensible Prompts und Daten auf Ihrem eigenen Rechner behalten können, während Agenten den Workflow mit menschlichen Kontrollpunkten (Human-in-the-Loop) abwickeln. Erfahren Sie, wie das zu einem schlanken Team passt, in Ein-Personen-Unternehmen mit KI-Agenten führen, oder laden Sie Eigent herunter, um es auszuprobieren.