Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Opret et svar med POST /v1/responses

Lektion 2 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Din første anmodning
  2. Godkendelse
  3. Minimal anmodning
  4. Med Python SDK
  5. Almindelig tekst kontra struktureret input
  6. Parameteren instructions
  7. Praktisk øvelse
  8. Vigtige pointer

Din første anmodning

Endpointet POST /v1/responses er hovedindgangen til Responses API. Det er her, du sender dine prompts og modtager svar fra Grok-modeller. I denne lektion lærer du at opbygge og sende din første anmodning.

Godkendelse

Alle anmodninger kræver en godkendelsesheader med din xAI API-nøgle:

Authorization: Bearer $XAI_API_KEY

Du kan generere dine nøgler på console.x.ai. Hold dem hemmelige – commit dem aldrig til et Git-repository.

Minimal anmodning

Her er den enklest mulige anmodning:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "input": "Explain what machine learning is in 3 sentences."
  }'

To felter er nok:

  • model: ID’et på den Grok-model, du vil bruge
  • input: din prompt som almindelig tekst

Med Python SDK

Hvis du bruger OpenAI SDK (xAI-kompatibel), er syntaksen lignende:

from openai import OpenAI

client = OpenAI(
    api_key="xai-...",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Explain what machine learning is in 3 sentences."
)

print(response.output[0].content[0].text)

Almindelig tekst kontra struktureret input

Parameteren input accepterer to formater.

Almindelig tekst

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the capital of France?"
}

Struktureret array

Til multimodale inputs eller eksplicitte roller:

{
  "model": "grok-4.20-0309-reasoning",
  "input": [
    {
      "role": "user",
      "content": "Analyze this image and describe what you see."
    }
  ]
}

Array-formatet giver dig mere kontrol, især når du skal inkludere billeder eller angive forskellige roller.

Parameteren instructions

For at give modellen en systemadfærd skal du bruge instructions i stedet for at tilføje en systembesked i input:

{
  "model": "grok-4.20-0309-reasoning",
  "instructions": "You are a French cuisine expert. Always respond including a chef's tip.",
  "input": "How do I make a successful béchamel?"
}

Feltet instructions svarer til system prompt i Chat Completions. Det definerer modellens overordnede adfærd for hele samtalen.

Praktisk øvelse

Prøv at opbygge en anmodning, der:

  1. Bruger modellen grok-4.20-0309-reasoning
  2. Definerer systeminstruktioner for en teknisk assistent
  3. Stiller et spørgsmål om Python
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "instructions": "You are a senior Python developer. Give concise code examples.",
    "input": "How do I read a JSON file in Python?"
  }'

Vigtige pointer

  • POST /v1/responses er hovedendpointet – det kræver model og input
  • input accepterer almindelig tekst eller et struktureret array med roller
  • instructions definerer modellens systemadfærd
  • Godkendelse sker via headeren Authorization: Bearer
  • OpenAI SDK er kompatibel med xAI ved at ændre base_url