Vytvoření odpovědi pomocí POST /v1/responses
Na této stránce
Tvůj první požadavek
Koncový bod POST /v1/responses je hlavním vstupním bodem pro API odpovědí (Responses API). Právě sem odesíláš své prompty a přijímáš odpovědi od modelů Grok. V této lekci se naučíš, jak sestavit a odeslat svůj první požadavek.
Autentizace
Všechny požadavky vyžadují hlavičku pro autentizaci s tvým API klíčem xAI:
Authorization: Bearer $XAI_API_KEY
Své klíče si můžeš vygenerovat na console.x.ai. Uchovávej je v tajnosti – nikdy je necommituj do Git repozitáře.
Minimální požadavek
Zde je úplně nejjednodušší možný požadavek:
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čí dvě pole:
model: ID modelu Grok, který chceš použítinput: tvůj prompt jako prostý text
S použitím Python SDK
Pokud používáš OpenAI SDK (kompatibilní s xAI), syntaxe je velmi 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)
Prostý text versus strukturovaný vstup
Parametr input přijímá dva formáty.
Prostý text
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the capital of France?"
}
Strukturované pole
Pro multimodální vstupy nebo explicitní definici rolí:
{
"model": "grok-4.20-0309-reasoning",
"input": [
{
"role": "user",
"content": "Analyze this image and describe what you see."
}
]
}
Formát pole ti dává větší kontrolu, zejména když potřebuješ zahrnout obrázky nebo určit různé role.
Parametr instructions
Chceš-li modelu definovat systémové chování, použij instructions místo přidávání systémové zprávy přímo 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 odpovídá „system prompt“ v Chat Completions. Definuje celkové chování modelu pro celou konverzaci.
Praktické cvičení
Zkus sestavit požadavek, který:
- Používá model
grok-4.20-0309-reasoning - Definuje systémové instrukce pro technického asistenta
- Klade otázku týkající se 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?"
}'
Klíčové poznatky
POST /v1/responsesje hlavní koncový bod – vyžadujemodelainputinputpřijímá prostý text nebo strukturované pole s rolemiinstructionsdefinuje systémové chování modelu- Autentizace probíhá prostřednictvím hlavičky
Authorization: Bearer - OpenAI SDK je kompatibilní s xAI po změně
base_url