Anfrageparameter
Auf dieser Seite
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_pstandardmäßig 0,95;max_output_tokensauf 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 mitprevious_response_idfalse: 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
| Parameter | Typ | Standardwert | Verwendung |
|---|---|---|---|
model | string | erforderlich | Modellkennung |
input | string/array | erforderlich | Benutzeranfrage |
instructions | string | null | Systemanweisung |
temperature | number | — | 0,7 empfohlen; auf 1 begrenzt |
top_p | number | 0,95 | Nucleus-Abtastung |
max_output_tokens | integer | 128.000 | Begrenzung der sichtbaren Antwort |
reasoning | object | null | Bemühung für Vernunftschritte |
store | boolean | null | 30-Tage-Persistenz |
stream | boolean | false | SSE-Streaming |
user | string | null | Endnutzer-ID |
Kernaussagen
- xAI empfiehlt
temperaturebei 0,7 undtop_pbei 0,95, explizit festgelegt max_output_tokensbegrenzt nur die sichtbare Antwort, Vernunftschritte sind ausgeschlossenstore: truepersistiert die Antwort für 30 Tage zur Gesprächskettungreasoning.effortermö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