Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

En enkel POST /v1/responses-förfrågan

Lektion 9 av 14 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. Ditt första lyckade anrop
  2. Struktur för förfrågan
  3. Anatomins hos svaret
  4. Vanliga valfria parametrar
  5. Fortsätt en konversation
  6. Spåra kostnader
  7. Viktiga punkter

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_p på 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ändas
  • input: 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 senare
  • status: completed när genereringen är klar
  • output: en array som innehåller de genererade meddelandena
  • usage: 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.7 och top_p=0.95 och 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: model och input
  • Svaret finns i output[0].content[0].text
  • Använd previous_response_id för konversationer över flera omgångar
  • Fältet usage hjälper dig att spåra din tokenförbrukning