Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Aanvraagparameters

Les 3 van 16 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Modelgedrag sturen
  2. Generatieparameters
  3. Conversatieparameters
  4. Tool-parameters
  5. Parameteroverzicht
  6. Belangrijkste punten

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_p standaard 0,95; max_output_tokens beperkt 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 met previous_response_id
  • false: 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

ParameterTypeStandaardGebruik
modelstringverplichtModel-identificatie
inputstring/arrayverplichtGebruikersprompt
instructionsstringnullSysteemprompt
temperaturenumber—0,7 aanbevolen; gemaximeerd op 1
top_pnumber0,95Nucleus-sampling
max_output_tokensinteger128.000Limiet zichtbare respons
reasoningobjectnullRedeneerinspanning
storebooleannullPersistentie van 30 dagen
streambooleanfalseSSE-streaming
userstringnullID eindgebruiker

Belangrijkste punten

  • xAI raadt aan temperature expliciet op 0,7 en top_p op 0,95 in te stellen
  • max_output_tokens beperkt alleen de zichtbare respons, exclusief redenering
  • store: true bewaart de respons 30 dagen voor het ketenen van conversaties
  • reasoning.effort laat u de reflectie van het model schalen op basis van de complexiteit van de taak
  • De parameter user helpt bij tracking en moderatie aan de kant van xAI