Jednoduchý požadavek POST /v1/responses
Na této stránce
Aktualizováno 3. listopadu 2026 na základě osvědčených postupů xAI a reference k API: teplota je omezena na hodnotu 1 a xAI doporučuje 0,7 s parametrem
top_pnastaveným na 0,95. Zdroj: Osvědčené postupy.
Tvůj první úspěšný požadavek
Máš založený účet, máš API klíč a nainstalované SDK. Je čas odeslat svůj první požadavek na Grok API a pochopit strukturu odpovědi. Tato lekce se zaměřuje na hlavní koncový bod /v1/responses, který je nejmodernější a nejvíce doporučovaný.
Struktura požadavku
Koncový bod POST /v1/responses vyžaduje alespoň dva parametry:
model: ID modelu, který chceš použítinput: text tvého požadavku (nebo pole obsahu pro pokročilé případy)
Minimální požadavek v Pythonu
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)
Se systémovými instrukcemi
Parametr instructions ti umožňuje definovat chování 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?"
)
Anatomie odpovědi
API vrací strukturovaný objekt JSON. Zde jsou hlavní pole:
{
"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á pole
id: unikátní ID odpovědi, užitečné pro její pozdější získánístatus:completed, když je generování dokončenooutput: pole obsahující vygenerované zprávyusage: počítadla tokenů pro sledování tvé spotřeby
Běžné volitelné parametry
Řízení kreativity
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # hodnota doporučená xAI
top_p=0.95,
)
- API přijímá teplotu v rozmezí od 0 do 2, ale jakoukoli vyšší hodnotu omezí na 1
- xAI doporučuje
temperature=0.7atop_p=0.95a radí se od nich neodchýlit: kvalita obvykle klesá - Pro větší kreativitu o ni požádej přímo v promptu („navrhni nečekané názvy“)
Omezení délky
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Omezí délku odpovědi
)
Zapnutí uvažování
U modelů zaměřených na uvažování uprav úsilí věnované myšlení:
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é úrovně jsou low, medium a high.
Pokračování v konverzaci
Koncový bod /v1/responses podporuje vícekolové konverzace prostřednictvím parametru previous_response_id:
# První zpráva
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Druhá zpráva (model si pamatuje kontext)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Tento přístup je jednodušší než ruční správa historie zpráv.
Sledování nákladů
Pole usage v odpovědi ti umožňuje vypočítat náklady na každé volání. Pole output_tokens_details.reasoning_tokens ukazuje, kolik tokenů bylo spotřebováno na interní uvažování modelu (tyto tokeny jsou zpoplatněny, ale v odpovědi se nezobrazují).
Klíčové poznatky
- Koncový bod
POST /v1/responsesje nejmodernější a nejvíce doporučovaný - Dva povinné parametry:
modelainput - Odpověď najdeš v
output[0].content[0].text - Pro vícekolové konverzace použij
previous_response_id - Pole
usageti pomáhá sledovat spotřebu tokenů