Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Een antwoord maken met POST /v1/responses

Les 2 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Uw eerste verzoek
  2. Authenticatie
  3. Minimaal verzoek
  4. Met de Python SDK
  5. Eenvoudige versus gestructureerde input
  6. De parameter instructions
  7. Praktische oefening
  8. Belangrijkste punten

Uw eerste verzoek

Het eindpunt POST /v1/responses is de belangrijkste toegangspoort voor de Responses API. Hier verzendt u uw prompts en ontvangt u antwoorden van Grok-modellen. In deze les leert u hoe u uw eerste verzoek opbouwt en verzendt.

Authenticatie

Alle verzoeken vereisen een authenticatieheader met uw xAI API-sleutel:

Authorization: Bearer $XAI_API_KEY

U kunt uw sleutels genereren op console.x.ai. Houd ze geheim; commit ze nooit naar een Git-repository.

Minimaal verzoek

Dit is het eenvoudigst mogelijke verzoek:

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."
  }'

Twee velden volstaan:

  • model: de ID van het te gebruiken Grok-model
  • input: uw prompt, als platte tekst

Met de Python SDK

Als u de OpenAI SDK (xAI-compatibel) gebruikt, is de syntaxis vergelijkbaar:

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)

Eenvoudige versus gestructureerde input

De parameter input accepteert twee formaten.

Platte tekst

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

Gestructureerde array

Voor multimodale inputs of expliciete rollen:

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

Het array-formaat biedt meer controle, vooral bij het opnemen van afbeeldingen of het specificeren van verschillende rollen.

De parameter instructions

Gebruik instructions om het model systeemgedrag mee te geven, in plaats van een systeembericht aan input toe te voegen:

{
  "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?"
}

Het veld instructions komt overeen met de system prompt bij Chat Completions. Het definieert het algehele gedrag van het model voor het hele gesprek.

Praktische oefening

Probeer een verzoek op te bouwen dat:

  1. Het model grok-4.20-0309-reasoning gebruikt
  2. Systeeminstructies definieert voor een technische assistent
  3. Een vraag over Python stelt
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?"
  }'

Belangrijkste punten

  • POST /v1/responses is het hoofdeindpunt; het vereist model en input
  • input accepteert platte tekst of een gestructureerde array met rollen
  • instructions definieert het systeemgedrag van het model
  • Authenticatie verloopt via de header Authorization: Bearer
  • De OpenAI SDK is compatibel met xAI door de base_url aan te passen