En enkel POST /v1/responses-förfrågan
På denna sida
Uppdaterat den 3 november 2026, baserat på xAI:s bästa praxis och API-referens: temperaturen är begränsad till 1, och xAI rekommenderar 0,7 med
top_ppå 0,95. Källa: Bästa praxis.
Ditt första lyckade anrop
Du har ditt konto, din API-nyckel och ett SDK installerat. Det är dags att skicka din första förfrågan till Grok API och förstå strukturen i svaret. Denna lektion fokuserar på huvudendpointen, /v1/responses, som är den modernaste och mest rekommenderade.
Struktur för förfrågan
Endpointen POST /v1/responses kräver minst två parametrar:
model: ID:t för modellen som ska användasinput: texten i din förfrågan (eller en array med innehåll för avancerade fall)
Minimal förfrågan i Python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="What's the most widely used programming language in 2026?"
)
print(response.output[0].content[0].text)
Med systeminstruktioner
Parametern instructions låter dig definiera modellens beteende:
response = client.responses.create(
model="grok-4.5",
instructions="You are a web development expert. Answer concisely.",
input="What's the difference between SSR and SSG?"
)
Anatomins hos svaret
API:t returnerar ett strukturerat JSON-objekt. Här är de viktigaste fälten:
{
"id": "resp-abc123",
"object": "response",
"status": "completed",
"model": "grok-4.5",
"output": [
{
"type": "message",
"content": [
{
"type": "output_text",
"text": "The model's answer appears here."
}
],
"status": "completed"
}
],
"usage": {
"input_tokens": 42,
"output_tokens": 156,
"total_tokens": 198
}
}
Viktiga fält
id: svarets unika ID, användbart för att hämta det senarestatus:completednär genereringen är klaroutput: en array som innehåller de genererade meddelandenausage: tokenräknare för att spåra din förbrukning
Vanliga valfria parametrar
Styr kreativiteten
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # det värde xAI rekommenderar
top_p=0.95,
)
- API:t accepterar en temperatur från 0 till 2, men capar alla högre värden vid 1
- xAI rekommenderar
temperature=0.7ochtop_p=0.95och avråder från att avvika från dessa: kvaliteten sjunker oftast - För mer kreativitet, be om det i prompten (“föreslå oväntade namn”)
Begränsa längden
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Begränsar svaret
)
Aktivera resonemang
För resonemangsmodeller, justera tankeinsatsen:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this problem: if 3x + 7 = 22, what is x?",
reasoning={"effort": "high"}
)
De möjliga nivåerna är low, medium och high.
Fortsätt en konversation
Endpointen /v1/responses stödjer konversationer över flera omgångar via parametern previous_response_id:
# Första meddelandet
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Andra meddelandet (modellen kommer ihåg kontexten)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Detta tillvägagångssätt är enklare än att hantera meddelandehistoriken själv.
Spåra kostnader
Fältet usage i svaret låter dig beräkna kostnaden för varje anrop. Fältet output_tokens_details.reasoning_tokens visar hur många tokens som gick åt till modellens interna resonemang (dessa tokens debiteras men syns inte i svaret).
Viktiga punkter
- Endpointen
POST /v1/responsesär den modernaste och mest rekommenderade - Två obligatoriska parametrar:
modelochinput - Svaret finns i
output[0].content[0].text - Använd
previous_response_idför konversationer över flera omgångar - Fältet
usagehjälper dig att spåra din tokenförbrukning