Responses API: objektet reasoning i detalj
På denna sida
Objektet reasoning i Responses API
xAI:s Responses API ger dig finjusterad kontroll över resonemang via objektet reasoning. Denna parameter finns endast tillgänglig i Responses API (inte i Chat Completions) och låter dig konfigurera tre aspekter av resonemanget: ansträngning, generering av sammanfattning och format för sammanfattningen.
Fullständig struktur för objektet reasoning
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Styr modellens djup i tänkandet. Tre möjliga värden:
low: minimalt tänkande, lämpat för enkla uppgiftermedium: balans mellan djup och hastighethigh: maximalt tänkande för komplexa problem
Denna parameter motsvarar reasoning_effort i Chat Completions, men med det tillagda värdet medium.
generate_summary
En boolesk variabel som anger om modellen ska producera en sammanfattning av sitt resonemang utöver det slutgiltiga svaret.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
När generate_summary är satt till true innehåller svaret ett ytterligare element med en koncis sammanfattning av resonemangsprocessen. Denna sammanfattning är i klartext (inte krypterad), vilket skiljer den från reasoning.encrypted_content.
summary
Styr formatet på den genererade sammanfattningen. Just nu är det enda dokumenterade värdet "auto", vilket låter modellen välja det mest lämpliga formatet.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Skillnad mellan sammanfattning och krypterat resonemang
Dessa två mekanismer kompletterar varandra men är distinkta:
| Aspekt | Sammanfattning (generate_summary) | Krypterat (include) |
|---|---|---|
| Läsbarhet | Klartext, begriplig | Krypterad, ogenomskinlig |
| Primär användning | Visning för användare, granskning | Återanvändning i efterföljande förfrågningar |
| Aktivering | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detaljnivå | Kondenserad sammanfattning | Fullständigt resonemang |
| Tillgänglighet | Endast Responses API | Endast Responses API |
Du kan aktivera båda samtidigt för att få både en läsbar sammanfattning och det fullständiga krypterade resonemanget:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Demonstrate the infinitude of prime numbers.",
reasoning={
"effort": "high",
"generate_summary": True,
"summary": "auto"
},
include=["reasoning.encrypted_content"]
)
Vanliga kombinationer
Minimal användning: Endast ansträngning
{
"reasoning": {
"effort": "low"
}
}
Modellen resonerar med minimal ansträngning. Ingen sammanfattning och inget krypterat resonemang returneras.
Mellannivå: Ansträngning + Sammanfattning
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Modellen resonerar och tillhandahåller en läsbar sammanfattning. Idealiskt för applikationer som vill visa tankeprocessen för användaren.
Fullständig användning: Ansträngning + Sammanfattning + Krypterat
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maximal konfiguration: djupt resonemang, läsbar sammanfattning och krypterat innehåll för återanvändning. Reservera detta för fall där du behöver allt.
När du ska utelämna objektet reasoning
Om du inte behöver styra resonemanget kan du helt enkelt utelämna parametern reasoning. Modellen kommer då att använda sina standardinställningar. Detta är giltigt och modellen kommer fortfarande att resonera (eftersom grok-4.20-0309-reasoning är en resonemangsmodell i grunden).
Viktiga punkter
- Objektet
reasoningfinns endast tillgängligt i Responses API effortstyr djupet (low,medium,high)generate_summaryproducerar en läsbar sammanfattning av resonemanget (klartext)summary: "auto"låter modellen välja format för sammanfattningen- Du kan kombinera sammanfattning och krypterat resonemang i samma förfrågan
- Att utelämna
reasoningär giltigt: modellen resonerar med standardinställningar