Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Anfrageparameter

Lektion 3 von 16 Aktualisiert am 3. November 2026 Entwickler
Auf dieser Seite
  1. Steuerung des Modellverhaltens
  2. Generierungsparameter
  3. Gesprächsparameter
  4. Tool-Parameter
  5. Parameterübersicht
  6. Kernaussagen

Aktualisiert am 3. November 2026. Basierend auf der Referenz der Responses API und den besten Praktiken von xAI: empfohlene Temperatur 0,7, auf 1 begrenzt; top_p standardmäßig 0,95; max_output_tokens auf die sichtbare Antwort beschränkt (128.000 Standardwert, Vernunftschritte nicht enthalten); Vernunftbemühungen (reasoning effort) vorbehalten für grok-4,5 bis 4,7. Quellen: Responses API · Beste Praktiken.

Steuerung des Modellverhaltens

Neben model, input und instructions bietet die Responses API zahlreiche Parameter, um das Verhalten von Grok zu verfeinern. Das Verständnis dieser Parameter ermöglicht es Ihnen, je nach Bedarf relevantere, kürzere oder kreativere Antworten zu erhalten.

Generierungsparameter

temperature

Steuert die Zufälligkeit der Antworten. Die API akzeptiert Werte von 0 bis 2, wobei jedoch alles über 1 auf 1 abgetastet wird.

{
  "model": "grok-4.7",
  "input": "Schreiben Sie ein Slogan für eine Bäckerei.",
  "temperature": 0.7,
  "top_p": 0.95
}

Die besten Praktiken von xAI sind eindeutig: Stellen Sie temperature auf 0,7 ein und weichen Sie nicht stark davon ab, da Grok-Modelle auf andere Abtast-Einstellungen schlecht reagieren. Passen Sie für einen faktenbasierten oder kreativeren Ton den Prompt an, nicht die Temperatur.

top_p

Nucleus-Abtastung. Aktuelle Textmodelle haben einen Standardwert von 0,95, und Werte, die über dem Modellstandard liegen, werden auf diesen reduziert.

{
  "model": "grok-4.7",
  "input": "Fassen Sie diesen Artikel zusammen.",
  "top_p": 0.95
}

Mit top_p: 0.95 berücksichtigt das Modell nur Token, die 95 % der Wahrscheinlichkeit ausmachen. Die API-Referenz wiederholt den klassischen Rat, nur einen der beiden Parameter anzupassen; die besten Praktiken von xAI verlangen stattdessen, beide Parameter explizit auf 0,7 und 0,95 bei jeder Anfrage festzulegen.

max_output_tokens

Begrenzt die Anzahl der Token in der sichtbaren Antwort; Vernunftschritte und Funktionsaufrufe zählen nicht dazu, und der Standardwert beträgt 128.000 Token:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Erklären Sie die allgemeine Relativitätstheorie.",
  "max_output_tokens": 500
}

Bei Vernunftmodellen regelt die Vernunftbemühung (reasoning effort), nicht diese Obergrenze, die interne Reflexion. Eine durch die Obergrenze abgeschnittene Antwort wird durch einen incomplete-Status signalisiert.

reasoning

Für Modelle, die Vernunftschritte unterstützen, können Sie die Bemühung anpassen:

{
  "model": "grok-4.7",
  "input": "Lösen Sie dieses logische Problem.",
  "reasoning": {"effort": "high"}
}

Mögliche Werte sind low, medium und high (Standard), sowie xhigh bei grok-4,6 und grok-4,7; der Parameter gilt für grok-4,5 bis 4,7, und grok-4.20-0309-reasoning akzeptiert ihn nicht. Hohe Bemühung verbraucht mehr Token und eignet sich für komplexe Probleme.

Gesprächsparameter

store

Bestimmt, ob die Antwort serverseitig gespeichert wird:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Analysieren Sie diesen Vertrag.",
  "store": false
}
  • true: Antwort wird für 30 Tage gespeichert, über GET abrufbar, nutzbar mit previous_response_id
  • false: Antwort wird nicht persistiert (Privatmodus)

previous_response_id

Verknüpft eine neue Anfrage mit einem bestehenden Gespräch (detailliert in Lektion 5).

user

Kennzeichnung des Endnutzers, nützlich für Tracking und Moderation:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Hallo",
  "user": "user-12345"
}

Tool-Parameter

tools, tool_choice, parallel_tool_calls, max_turns

Diese Parameter steuern die Tool-Nutzung (web_search, code_interpreter, benutzerdefinierte Funktionen). Sie werden im Abschnitt „Tools” (Lektionen 9–12) detailliert behandelt.

Parameterübersicht

ParameterTypStandardwertVerwendung
modelstringerforderlichModellkennung
inputstring/arrayerforderlichBenutzeranfrage
instructionsstringnullSystemanweisung
temperaturenumber—0,7 empfohlen; auf 1 begrenzt
top_pnumber0,95Nucleus-Abtastung
max_output_tokensinteger128.000Begrenzung der sichtbaren Antwort
reasoningobjectnullBemühung für Vernunftschritte
storebooleannull30-Tage-Persistenz
streambooleanfalseSSE-Streaming
userstringnullEndnutzer-ID

Kernaussagen

  • xAI empfiehlt temperature bei 0,7 und top_p bei 0,95, explizit festgelegt
  • max_output_tokens begrenzt nur die sichtbare Antwort, Vernunftschritte sind ausgeschlossen
  • store: true persistiert die Antwort für 30 Tage zur Gesprächskettung
  • reasoning.effort ermöglicht es Ihnen, die Reflexion des Modells basierend auf der Aufgabenkomplexität zu skalieren
  • Der user-Parameter hilft bei Tracking und Moderation auf der Seite von xAI