Opret et svar med POST /v1/responses
På denne side
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 brugeinput: 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:
- Bruger modellen
grok-4.20-0309-reasoning - Definerer systeminstruktioner for en teknisk assistent
- 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/responseser hovedendpointet – det krævermodeloginputinputaccepterer almindelig tekst eller et struktureret array med rollerinstructionsdefinerer modellens systemadfærd- Godkendelse sker via headeren
Authorization: Bearer - OpenAI SDK er kompatibel med xAI ved at ændre
base_url