Válasz létrehozása a POST /v1/responses végponttal
Ezen az oldalon
Az első kérésed
A POST /v1/responses végpont a Responses API fő belépési pontja. Ide küldöd el a promptjaidat, és innen kapod meg a Grok modellek válaszait. Ebben a leckében megtanulod, hogyan építsd fel és küldd el az első kérésedet.
Hitelesítés
Minden kéréshez szükség van egy hitelesítési fejlécre, amely tartalmazza az xAI API-kulcsodat:
Authorization: Bearer $XAI_API_KEY
A kulcsokat a console.x.ai oldalon generálhatod le. Tartsd őket titokban – soha ne commitold őket Git tárolóba.
Minimális kérés
Íme a lehető legegyszerűbb kérés:
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."
}'
Két mező elegendő:
model: a használni kívánt Grok modell azonosítójainput: a promptod egyszerű szövegként
A Python SDK használatával
Ha az OpenAI SDK-t használod (amely kompatibilis az xAI-val), a szintaxis hasonló:
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)
Egyszerű vs. strukturált bemenet
Az input paraméter két formátumot fogad el.
Egyszerű szöveg
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?"
}
Strukturált tömb
Többmódusú (multimodális) bemenetekhez vagy explicit szerepek meghatározásához:
{
"model": "grok-4.20-0309-reasoning",
"input": [
{
"role": "user",
"content": "Analyze this image and describe what you see."
}
]
}
A tömbös formátum nagyobb kontrollt biztosít, különösen képek beszúrásakor vagy különböző szerepek meghatározásakor.
Az instructions paraméter
Ha rendszer-szintű viselkedést szeretnél megadni a modellnek, az instructions mezőt használd ahelyett, hogy rendszerüzenetet adnál hozzá az inputhoz:
{
"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?"
}
Az instructions mező egyenértékű a Chat Completions API system promptjával. Ez határozza meg a modell általános viselkedését a teljes beszélgetés során.
Gyakorlati feladat
Próbálj meg összeállítani egy olyan kérést, amely:
- A
grok-4.20-0309-reasoningmodellt használja - Rendszerutasításokat definiál egy technikai asszisztens számára
- Feltesz egy kérdést Pythonnal kapcsolatban
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?"
}'
Főbb megállapítások
- A
POST /v1/responsesa fő végpont – megköveteli amodelés azinputmezőket - Az
inputelfogad egyszerű szöveget vagy szerepeket tartalmazó strukturált tömböt - Az
instructionshatározza meg a modell rendszer-szintű viselkedését - A hitelesítés az
Authorization: Bearerfejlécen keresztül történik - Az OpenAI SDK az
base_urlmódosításával kompatibilissé tehető az xAI-val