Jednoduchá požiadavka POST /v1/responses
Na tejto strane
Aktualizované 3. novembra 2026 na základe osvedčených postupov xAI a referencie API: hodnota teploty je obmedzená na 1 a xAI odporúča 0,7 s
top_pnastaveným na 0,95. Zdroj: Osvedčené postupy.
Tvoj prvý úspešný volanie
Máš svoj účet, svoj API kľúč a nainštalované SDK. Je čas odoslať tvoju prvú požiadavku do API Grok a pochopiť štruktúru odpovede. Táto lekcia sa zameriava na hlavný koncový bod /v1/responses, ktorý je najmodernejší a najviac odporúčaný.
Štruktúra požiadavky
Koncový bod POST /v1/responses vyžaduje aspoň dva parametre:
model: ID modelu, ktorý chceš použiťinput: text tvojej požiadavky (alebo pole obsahu pre pokročilé prípady)
Minimálna požiadavka v Pythone
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="What's the most widely used programming language in 2026?"
)
print(response.output[0].content[0].text)
So systémovými inštrukciami
Parameter instructions ti umožňuje definovať správanie modelu:
response = client.responses.create(
model="grok-4.5",
instructions="You are a web development expert. Answer concisely.",
input="What's the difference between SSR and SSG?"
)
Anatómia odpovede
API vráti štruktúrovaný objekt JSON. Tu sú hlavné polia:
{
"id": "resp-abc123",
"object": "response",
"status": "completed",
"model": "grok-4.5",
"output": [
{
"type": "message",
"content": [
{
"type": "output_text",
"text": "The model's answer appears here."
}
],
"status": "completed"
}
],
"usage": {
"input_tokens": 42,
"output_tokens": 156,
"total_tokens": 198
}
}
Dôležité polia
id: jedinečné ID odpovede, užitočné na jej neskoršie získaniestatus:completed, keď je generovanie dokončenéoutput: pole obsahujúce vygenerované správyusage: počítadlá tokenov na sledovanie tvojej spotreby
Bežné voliteľné parametre
Kontrola kreativity
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # hodnota odporúčaná xAI
top_p=0.95,
)
- API akceptuje teplotu od 0 do 2, ale akúkoľvek vyššiu hodnotu oreže na 1
- xAI odporúča
temperature=0.7atop_p=0.95a neodporúča sa od nich odchyľovať: kvalita zvyčajne klesá - Pre viac kreativity o ňu požiadaj priamo v promte („navrhni nečakané názvy“)
Obmedzenie dĺžky
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Obmedzí odpoveď
)
Zapnutie uvažovania
Pre modely s uvažovaním uprav úsilie o myslenie:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Solve this problem: if 3x + 7 = 22, what is x?",
reasoning={"effort": "high"}
)
Možné úrovne sú low, medium a high.
Pokračovanie v konverzácii
Koncový bod /v1/responses podporuje viacnásobné konverzácie prostredníctvom parametra previous_response_id:
# Prvá správa
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Druhá správa (model si pamätá kontext)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Tento prístup je jednoduchší ako ručné spravovanie histórie správ.
Sledovanie nákladov
Pole usage v odpovedi ti umožňuje vypočítať náklady na každé volanie. Pole output_tokens_details.reasoning_tokens ukazuje, koľko tokenov išlo do interného uvažovania modelu (tieto tokeny sa účtujú, ale nezobrazujú sa v odpovedi).
Kľúčové poznatky
- Koncový bod
POST /v1/responsesje najmodernejší a najviac odporúčaný - Dva požadované parametre:
modelainput - Odpoveď nájdeš v
output[0].content[0].text - Na viacnásobné konverzácie použi
previous_response_id - Pole
usageti pomáha sledovať spotrebu tokenov