Aanvraagparameters
Op deze pagina
Bijgewerkt op 3 november 2026. Gebaseerd op de referentie van de Responses API en de best practices van xAI: aanbevolen temperatuur 0,7, gemaximeerd op 1;
top_pstandaard 0,95;max_output_tokensbeperkt tot de zichtbare respons (standaard 128.000, redenering niet meegerekend); redeneerinspanning voorbehouden aan grok-4.5 tot 4.7. Bronnen: Responses API · Best practices.
Modelgedrag sturen
Naast model, input en instructions biedt de Responses API talrijke parameters om het gedrag van Grok fijn af te stellen. Inzicht in deze parameters stelt u in staat om, afhankelijk van uw behoeften, relevantere, kortere of creatievere antwoorden te verkrijgen.
Generatieparameters
temperature
Regelt de willekeurigheid van de antwoorden. De API accepteert waarden van 0 tot 2, maar alles boven 1 wordt gesampled op 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
De best practices van xAI zijn duidelijk: stel temperature in op 0,7 en wijk hier niet ver van af, omdat Grok-modellen slecht reageren op andere sampling-instellingen. Pas voor een meer feitelijke of creatieve toon liever de prompt aan dan de temperatuur.
top_p
Nucleus-sampling. Huidige tekstmodellen hanteren standaard 0,95; elke waarde hoger dan dit modeldefault wordt hierop teruggebracht.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Met top_p: 0.95 neemt het model alleen tokens in overweging die samen 95% van de waarschijnlijkheid uitmaken. De API-referentie herhaalt het klassieke advies om slechts één van de twee parameters aan te passen; de best practices van xAI vereisen echter dat u beide expliciet instelt op respectievelijk 0,7 en 0,95 bij elk verzoek.
max_output_tokens
Beperkt het aantal tokens in de zichtbare respons; redenering en functieaanroepen tellen niet mee. De standaardwaarde is 128.000 tokens:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
Bij redeneermodellen wordt de interne reflectie niet door deze limiet, maar door de redeneerinspanning (reasoning effort) bepaald. Een respons die door de limiet wordt afgebroken, krijgt de status incomplete.
reasoning
Voor modellen die redeneren ondersteunen, kunt u de inspanning aanpassen:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Mogelijke waarden zijn low, medium en high (standaard), plus xhigh voor grok-4.6 en grok-4.7. De parameter is van toepassing op grok-4.5 tot 4.7; grok-4.20-0309-reasoning accepteert deze niet. Een hoge inspanning verbruikt meer tokens en is geschikt voor complexe problemen.
Conversatieparameters
store
Bepaalt of de respons server-side wordt opgeslagen:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: respons wordt 30 dagen bewaard, ophaalbaar via GET, bruikbaar metprevious_response_idfalse: respons wordt niet persistent opgeslagen (privémodus)
previous_response_id
Koppelt een nieuw verzoek aan een bestaande conversatie (uitgewerkt in les 5).
user
Identificatie van de eindgebruiker, nuttig voor tracking en moderatie:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Tool-parameters
tools, tool_choice, parallel_tool_calls, max_turns
Deze parameters sturen het gebruik van tools (web_search, code_interpreter, aangepaste functies). Ze worden gedetailleerd behandeld in het hoofdstuk “Tools” (lessen 9-12).
Parameteroverzicht
| Parameter | Type | Standaard | Gebruik |
|---|---|---|---|
model | string | verplicht | Model-identificatie |
input | string/array | verplicht | Gebruikersprompt |
instructions | string | null | Systeemprompt |
temperature | number | — | 0,7 aanbevolen; gemaximeerd op 1 |
top_p | number | 0,95 | Nucleus-sampling |
max_output_tokens | integer | 128.000 | Limiet zichtbare respons |
reasoning | object | null | Redeneerinspanning |
store | boolean | null | Persistentie van 30 dagen |
stream | boolean | false | SSE-streaming |
user | string | null | ID eindgebruiker |
Belangrijkste punten
- xAI raadt aan
temperatureexpliciet op 0,7 entop_pop 0,95 in te stellen max_output_tokensbeperkt alleen de zichtbare respons, exclusief redeneringstore: truebewaart de respons 30 dagen voor het ketenen van conversatiesreasoning.effortlaat u de reflectie van het model schalen op basis van de complexiteit van de taak- De parameter
userhelpt bij tracking en moderatie aan de kant van xAI