Preprost zahtevek POST /v1/responses
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi najboljših praks xAI in referenčne dokumentacije API-ja: temperatura je omejena na 1, xAI pa priporoča 0,7 z vrednostjo
top_p0,95. Vir: Najboljše prakse.
Tvoj prvi uspešen klic
Imaš svoj račun, ključ API in nameščen SDK. Čas je, da pošlješ svoj prvi zahtevek API-ju Grok in razumeš strukturo odgovora. Ta lekcija se osredotoča na glavno končno točko /v1/responses, ki je najbolj sodobna in najbolj priporočljiva.
Struktura zahtevka
Končna točka POST /v1/responses zahteva vsaj dva parametra:
model: ID modela, ki ga želiš uporabitiinput: besedilo tvojega zahtevka (ali polje vsebine za napredne primere)
Minimalen zahtevek 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)
Z navodili sistema
Parameter instructions ti omogoča definiranje obnašanja modela:
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?"
)
Anatomija odgovora
API vrne strukturiran objekt JSON. Tu so glavna polja:
{
"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
}
}
Pomembna polja
id: edinstveni ID odgovora, uporaben za kasnejše pridobivanjestatus:completed, ko je generiranje končanooutput: polje, ki vsebuje generirana sporočilausage: števci žetonov za sledenje tvoji porabi
Pogosti izbirni parametri
Nadzor ustvarjalnosti
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # vrednost, ki jo priporoča xAI
top_p=0.95,
)
- API sprejme temperaturo od 0 do 2, vendar vsako višjo vrednost omeji na 1
- xAI priporoča
temperature=0.7intop_p=0.95ter odsvetuje odstopanje od teh vrednosti: kakovost se običajno zmanjša - Za več ustvarjalnosti to zahtevaj v pozivu („predlagaj nepričakovana imena”)
Omejitev dolžine
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Omeji odgovor
)
Vklop razmišljanja
Pri modelih za razmišljanje prilagodi napor razmišljanja:
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žne ravni so low, medium in high.
Nadaljevanje pogovora
Končna točka /v1/responses podpira večkratne pogovore s parametrom previous_response_id:
# Prvo sporočilo
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Drugo sporočilo (model si zapomni kontekst)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Ta pristop je preprostejši od ročnega upravljanja zgodovine sporočil.
Sledenje stroškom
Polje usage v odgovoru ti omogoča izračun stroška vsakega klica. Polje output_tokens_details.reasoning_tokens prikazuje, koliko žetonov je šlo v notranje razmišljanje modela (ti žetoni se zaračunajo, vendar se ne prikažejo v odgovoru).
Ključne ugotovitve
- Končna točka
POST /v1/responsesje najbolj sodobna in najbolj priporočljiva - Dva zahtevana parametra:
modelininput - Odgovor najdeš v
output[0].content[0].text - Za večkratne pogovore uporabi
previous_response_id - Polje
usageti pomaga slediti porabi žetonov