Jednostavan zahtjev POST /v1/responses
Na ovoj stranici
Ažurirano 3. studenoga 2026., na temelju najboljih praksi xAI-ja i referenci API-ja: temperatura je ograničena na 1, a xAI preporučuje 0.7 uz
top_pod 0.95. Izvor: Najbolje prakse.
Tvoj prvi uspješan poziv
Imaš svoj račun, API ključ i instaliran SDK. Vrijeme je da pošalješ svoj prvi zahtjev Grok API-ju i razumiješ strukturu odgovora. Ova lekcija fokusira se na glavnu krajnju točku, /v1/responses, koja je najmodernija i najpreporučenija.
Struktura zahtjeva
Krajnja točka POST /v1/responses zahtijeva najmanje dva parametra:
model: ID modela koji ćeš koristitiinput: tekst tvog zahtjeva (ili polje sadržaja za napredne slučajeve)
Minimalan zahtjev u 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)
Sa sistemskim uputama
Parametar instructions omogućuje ti definiranje ponaš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 vraća strukturirani JSON objekt. Evo glavnih 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
}
}
Važna polja
id: jedinstveni ID odgovora, koristan za kasnije dohvaćanjestatus:completedkada je generiranje završenooutput: polje koje sadrži generirane porukeusage: brojači tokena za praćenje tvoje potrošnje
Uobičajeni opcionalni parametri
Kontrola kreativnosti
response = client.responses.create(
model="grok-4.5",
input="Suggest a name for an AI startup.",
temperature=0.7, # vrijednost koju preporučuje xAI
top_p=0.95,
)
- API prihvaća temperaturu od 0 do 2, ali svaku veću vrijednost ograničava na 1
- xAI preporučuje
temperature=0.7itop_p=0.95te savjetuje odstupanje od njih: kvaliteta obično pada - Za veću kreativnost, zatraži to u promptu („predloži neočekivana imena“)
Ograničenje duljine
response = client.responses.create(
model="grok-4.5",
input="Summarize the concept of machine learning.",
max_output_tokens=200 # Ograničava odgovor
)
Uključivanje rezoniranja
Za modele za rezoniranje 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"}
)
Moguće razine su low, medium i high.
Nastavak razgovora
Krajnja točka /v1/responses podržava razgovore u više koraka putem parametra previous_response_id:
# Prva poruka
r1 = client.responses.create(
model="grok-4.5",
input="I'm building an API in Python."
)
# Druga poruka (model pamti kontekst)
r2 = client.responses.create(
model="grok-4.5",
input="Which framework do you recommend?",
previous_response_id=r1.id
)
Ovaj je pristup jednostavniji od samostalnog upravljanja poviješću poruka.
Praćenje troškova
Polje usage u odgovoru omogućuje ti izračun troška svakog poziva. Polje output_tokens_details.reasoning_tokens pokazuje koliko je tokena utrošeno na interno rezoniranje modela (ti se tokeni naplaćuju, ali se ne pojavljuju u odgovoru).
Ključne točke
- Krajnja točka
POST /v1/responsesnajmodernija je i najpreporučenija - Dva obavezna parametra:
modeliinput - Odgovor se nalazi u
output[0].content[0].text - Koristi
previous_response_idza razgovore u više koraka - Polje
usagepomaže ti pratiti potrošnju tokena