Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Gesprekken koppelen

Les 5 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Gesprekken voeren zonder geschiedenisbeheer
  2. Volledig Python-voorbeeld
  3. curl-equivalent
  4. Koppelen en instructies
  5. Limieten voor koppelen
  6. Belangrijkste punten

Gesprekken voeren zonder geschiedenisbeheer

Een groot voordeel van de Responses API is het koppelen van gesprekken via previous_response_id. In plaats van bij elk verzoek de volledige geschiedenis opnieuw te verzenden, geeft u eenvoudigweg de ID van het vorige antwoord door. De xAI-server zorgt voor het reconstrueren van de volledige context.

1

Eerste verzoek

Verstuur uw initiële prompt. Haal de antwoord-ID op (resp-xxx).

2

Volgende verzoeken

Geef previous_response_id door samen met uw nieuwe bericht. De server reconstrueert de context.

3

Volledig gesprek

Koppel zoveel berichten als nodig. Elk antwoord verwijst naar het vorige.

Volledig Python-voorbeeld

from openai import OpenAI

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

# Beurt 1: Introductie
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    instructions="You are a patient and clear math teacher.",
    input="Hello, I would like to understand derivatives."
)
print(response1.output[0].content[0].text)

# Beurt 2: Het model onthoudt de context
response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Can you give me a concrete example?",
    previous_response_id=response1.id
)
print(response2.output[0].content[0].text)

# Beurt 3: Verdieping
response3 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="And how do I calculate the derivative of x² + 3x?",
    previous_response_id=response2.id
)
print(response3.output[0].content[0].text)

Merk op dat elk verzoek na het eerste alleen het nieuwe bericht en de referentie naar het vorige antwoord bevat. De xAI-server reconstrueert automatisch de volledige geschiedenis.

curl-equivalent

# Beurt 1
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": "Hello, explain the basics of Python to me."
  }'
# Haal de ID op uit het antwoord: "id": "resp-abc123"

# Beurt 2
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": "How do I write a for loop?",
    "previous_response_id": "resp-abc123"
  }'

Koppelen en instructies

De instructions (systeemprompt) die in het eerste verzoek zijn gedefinieerd, blijven behouden tijdens het gekoppelde gesprek. U hoeft deze niet te herhalen.

Als u instructions wijzigt in een gekoppeld verzoek, vervangen de nieuwe instructies de vorige voor dat verzoek en alle daaropvolgende verzoeken.

Limieten voor koppelen

  • Het geraadpleegde antwoord moet op de server bestaan (hetzij store: true, hetzij een recent verzoek)
  • Koppelen bouwt geschiedenistokens op: elk verzoek wordt gef factureerd voor het volledige gesprek
  • Er is geen limiet aan het aantal beurten, maar het contextvenster van het model is wel van toepassing

Belangrijkste punten

  • previous_response_id koppelt gesprekken zonder de geschiedenis opnieuw te verzenden
  • De server reconstrueert automatisch de volledige context
  • Systeeminstructies blijven van beurt tot beurt behouden
  • Elke beurt wordt gefactureerd voor de volledige opgebouwde geschiedenis
  • Het geraadpleegde antwoord moet op de server zijn opgeslagen