Een antwoord maken met POST /v1/responses
Op deze pagina
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-modelinput: 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:
- Het model
grok-4.20-0309-reasoninggebruikt - Systeeminstructies definieert voor een technische assistent
- 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/responsesis het hoofdeindpunt; het vereistmodeleninputinputaccepteert platte tekst of een gestructureerde array met rolleninstructionsdefinieert het systeemgedrag van het model- Authenticatie verloopt via de header
Authorization: Bearer - De OpenAI SDK is compatibel met xAI door de
base_urlaan te passen