Vytvorenie odpovede pomocou POST /v1/responses
Na tejto strane
Tvoja prvá požiadavka
Koncový bod POST /v1/responses je hlavným vstupným bodom pre API odpovedí (Responses API). Sem odosielaš svoje výzvy (prompty) a dostávaš odpovede od modelov Grok. V tejto lekcii sa naučíš, ako zostaviť a odoslať svoju prvú požiadavku.
Autentifikácia
Všetky požiadavky vyžadujú hlavičku autentifikácie s tvojím kľúčom xAI API:
Authorization: Bearer $XAI_API_KEY
Svoje kľúče si môžeš vygenerovať na console.x.ai. Uchovávaj ich v tajnosti – nikdy ich neodosielaj do repozitára Git.
Minimálna požiadavka
Tu je úplne najjednoduchšia možná požiadavka:
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."
}'
Stačia dve polia:
model: identifikátor modelu Grok, ktorý chceš použiťinput: tvoja výzva ako obyčajný text
Pomocou Python SDK
Ak používaš OpenAI SDK (kompatibilné s xAI), syntax je podobná:
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)
Jednoduchý vs. štruktúrovaný vstup
Parameter input akceptuje dva formáty.
Obyčajný text
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?"
}
Štruktúrované pole
Pre multimodálne vstupy alebo explicitné určenie rolí:
{
"model": "grok-4.20-0309-reasoning",
"input": [
{
"role": "user",
"content": "Analyze this image and describe what you see."
}
]
}
Formát poľa ti dáva väčšiu kontrolu, najmä pri vkladaní obrázkov alebo určovaní rôznych rolí.
Parameter instructions
Ak chceš modelu definovať systémové správanie, použi parameter instructions namiesto pridávania systémovej správy do 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?"
}
Pole instructions je ekvivalentom „systémového promptu“ (system prompt) v Chat Completions. Definuje celkové správanie modelu pre celú konverzáciu.
Praktické cvičenie
Skús zostaviť požiadavku, ktorá:
- Používa model
grok-4.20-0309-reasoning - Definuje systémové inštrukcie pre technického asistenta
- Kladie otázku týkajúcu sa Pythonu
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?"
}'
Kľúčové poznatky
POST /v1/responsesje hlavný koncový bod – vyžaduje parametremodelainputinputakceptuje obyčajný text alebo štruktúrované pole s rolamiinstructionsdefinuje systémové správanie modelu- Autentifikácia prebieha prostredníctvom hlavičky
Authorization: Bearer - OpenAI SDK je kompatibilné s xAI po zmene parametra
base_url