Begärningsparametrar
På denna sida
Uppdaterad den 3 november 2026. Baserat på referensen för Responses API och bästa praxis från xAI: rekommenderad temperatur 0,7, maximerad till 1;
top_p0,95 som standard;max_output_tokensbegränsat till synligt svar (128 000 som standard, resonemang exkluderat); ansträngning för resonemang reserverad för grok-4.5 till 4.7. Källor: Responses API · Bästa praxis.
Styr modellens beteende
Utöver model, input och instructions erbjuder Responses API många parametrar för att finjustera Groks beteende. Genom att förstå dessa parametrar kan du få mer relevanta, kortare eller mer kreativa svar beroende på dina behov.
Genereringsparametrar
temperature
Styr slumpmässigheten i svaren. API:t accepterar värden från 0 till 2, men allt över 1 samplas som 1.
{
"model": "grok-4.7",
"input": "Write a slogan for a bakery.",
"temperature": 0.7,
"top_p": 0.95
}
xAI:s bästa praxis är tydlig: ställ in temperature på 0,7 och avvika inte mycket från detta, eftersom Grok-modeller reagerar dåligt på andra samplingsinställningar. Justera prompten snarare än temperaturen om du vill ha en mer faktabaserad eller kreativ ton.
top_p
Kärnsampling (nucleus sampling). Nuvarande textmodeller har 0,95 som standard, och alla värden högre än modellens standard reduceras till detta.
{
"model": "grok-4.7",
"input": "Summarize this article.",
"top_p": 0.95
}
Med top_p: 0.95 beaktar modellen endast de token som står för 95 % av sannolikheten. API-referensen upprepar det klassiska rådet att bara justera en av de två parametrarna, men xAI:s bästa praxis kräver istället att du uttryckligen anger båda till 0,7 respektive 0,95 vid varje begäran.
max_output_tokens
Begränsar antalet token i det synliga svaret; resonemang och funktionsanrop räknas inte, och standardvärdet är 128 000 token:
{
"model": "grok-4.20-0309-reasoning",
"input": "Explain general relativity.",
"max_output_tokens": 500
}
För resonemangsmodeller styrs den interna reflektionen av ansträngningen för resonemang, inte av denna gräns. Ett svar som klipps av på grund av gränsen signaleras med statusen incomplete.
reasoning
För modeller som stöder resonemang kan du justera ansträngningen:
{
"model": "grok-4.7",
"input": "Solve this logic problem.",
"reasoning": {"effort": "high"}
}
Möjliga värden är low, medium och high (standard), samt xhigh för grok-4.6 och grok-4.7. Parametern gäller för grok-4.5 till 4.7, och grok-4.20-0309-reasoning accepterar den inte. Hög ansträngning förbrukar fler token och passar komplexa problem.
Konversationsparametrar
store
Avgör om svaret lagras på serversidan:
{
"model": "grok-4.20-0309-reasoning",
"input": "Analyze this contract.",
"store": false
}
true: svaret lagras i 30 dagar, kan hämtas via GET och användas medprevious_response_idfalse: svaret sparas inte (privat läge)
previous_response_id
Länkar en ny begäran till en befintlig konversation (behandlas ingående i lektion 5).
user
Identifierare för slutanvändaren, användbar för spårning och moderering:
{
"model": "grok-4.20-0309-reasoning",
"input": "Hello",
"user": "user-12345"
}
Verktygsparametrar
tools, tool_choice, parallel_tool_calls, max_turns
Dessa parametrar styr användningen av verktyg (web_search, code_interpreter, anpassade funktioner). De behandlas ingående i avsnittet “Verktyg” (lektion 9–12).
Sammanfattning av parametrar
| Parameter | Typ | Standard | Användning |
|---|---|---|---|
model | string | required | Modellidentifierare |
input | string/array | required | Användarprompt |
instructions | string | null | Systemprompt |
temperature | number | — | 0,7 rekommenderas; maximeras till 1 |
top_p | number | 0,95 | Kärnsampling |
max_output_tokens | integer | 128 000 | Gräns för synligt svar |
reasoning | object | null | Ansträngning för resonemang |
store | boolean | null | Lagring i 30 dagar |
stream | boolean | false | SSE-strömning |
user | string | null | ID för slutanvändare |
Viktiga punkter
- xAI rekommenderar
temperaturepå 0,7 ochtop_ppå 0,95, angivna explicit max_output_tokensbegränsar endast det synliga svaret, exklusive resonemangstore: truesparar svaret i 30 dagar för att möjliggöra konversationskedjorreasoning.effortlåter dig skala modellens reflektion baserat på uppgiftens komplexitet- Parametern
userhjälper till med spårning och moderering på xAI:s sida