Anmodningsparametre
På denne side
Opdateret 3. november 2026. Baseret på referencen til Responses API og xAI’s bedste praksis: anbefalet temperatur 0,7, begrænset til 1;
top_pstandardmæssigt 0,95;max_output_tokensbegrænset til synligt svar (128.000 som standard, ræsonnement ekskluderet); ræsonnementsindsats forbeholdt grok-4.5 til 4.7. Kilder: Responses API · Bedste praksis.
Styr modeladfærd
Ud over model, input og instructions tilbyder Responses API en række parametre til finjustering af Groks adfærd. Når du forstår disse parametre, kan du få mere relevante, kortere eller mere kreative svar afhængigt af dine behov.
Genereringsparametre
temperature
Styrer tilfældigheden i svarene. API’et accepterer værdier fra 0 til 2, men alt over 1 samples ved 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
xAI’s bedste praksis er klar: sæt temperature til 0,7 og afvig ikke meget fra dette, da Grok-modeller reagerer dårligt på andre sample-indstillinger. Justér prompten i stedet for temperaturen, hvis du ønsker en mere faktuel eller kreativ tone.
top_p
Nukleus-sampling. Nuværende tekstmodeller har standardværdien 0,95, og enhver værdi højere end modellens standard reduceres til denne.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Med top_p: 0.95 overvejer modellen kun tokens, der udgør 95 % af sandsynligheden. API-referencen gentager det klassiske råd om kun at justere én af de to parametre; xAI’s bedste praksis kræver derimod, at du eksplicit angiver begge til henholdsvis 0,7 og 0,95 ved hver anmodning.
max_output_tokens
Begrænser antallet af tokens i det synlige svar; ræsonnement og funktionskald tælles ikke med, og standardværdien er 128.000 tokens:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
For ræsonnementsmodeller styres den interne refleksion af ræsonnementsindsatsen, ikke af denne grænse. Et svar, der afbrydes af grænsen, signaleres med statussen incomplete.
reasoning
For modeller, der understøtter ræsonnement, kan du justere indsatsen:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Mulige værdier er low, medium og high (standard), plus xhigh på grok-4.6 og grok-4.7; parameteren gælder for grok-4.5 til 4.7, og grok-4.20-0309-reasoning accepterer den ikke. Høj indsats bruger flere tokens og egner sig til komplekse problemer.
Konversationsparametre
store
Bestemmer, om svaret gemmes på serversiden:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: svar gemmes i 30 dage, kan hentes via GET og bruges medprevious_response_idfalse: svar gemmes ikke (privat tilstand)
previous_response_id
Kæder en ny anmodning til en eksisterende samtale (beskrevet detaljeret i lektion 5).
user
Identifikator for slutbrugeren, nyttig til sporing og moderation:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Værktøjsparametre
tools, tool_choice, parallel_tool_calls, max_turns
Disse parametre styrer brugen af værktøjer (web_search, code_interpreter, brugerdefinerede funktioner). De dækkes i detaljer i afsnittet „Værktøjer” (lektion 9-12).
Oversigt over parametre
| Parameter | Type | Standard | Anvendelse |
|---|---|---|---|
model | string | påkrævet | Modelidentifikator |
input | string/array | påkrævet | Brugerprompt |
instructions | string | null | Systemprompt |
temperature | number | — | 0,7 anbefales; begrænset til 1 |
top_p | number | 0,95 | Nukleus-sampling |
max_output_tokens | integer | 128.000 | Grænse for synligt svar |
reasoning | object | null | Ræsonnementsindsats |
store | boolean | null | 30-dages lagring |
stream | boolean | false | SSE-streaming |
user | string | null | Slutbruger-ID |
Vigtige pointer
- xAI anbefaler
temperaturepå 0,7 ogtop_ppå 0,95, angivet eksplicit max_output_tokensbegrænser kun det synlige svar og ekskluderer ræsonnementstore: truegemmer svaret i 30 dage til kædning af samtalerreasoning.effortlader dig skalere modellens refleksion baseret på opgavens kompleksitet- Parameteren
userhjælper med sporing og moderation på xAI’s side