Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Jednostavan zahtjev POST /v1/responses

Lekcija 9 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Tvoj prvi uspješan poziv
  2. Struktura zahtjeva
  3. Anatomija odgovora
  4. Uobičajeni opcionalni parametri
  5. Nastavak razgovora
  6. Praćenje troškova
  7. Ključne točke

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_p od 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š koristiti
  • input: 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ćanje
  • status: completed kada je generiranje završeno
  • output: polje koje sadrži generirane poruke
  • usage: 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.7 i top_p=0.95 te 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/responses najmodernija je i najpreporučenija
  • Dva obavezna parametra: model i input
  • Odgovor se nalazi u output[0].content[0].text
  • Koristi previous_response_id za razgovore u više koraka
  • Polje usage pomaže ti pratiti potrošnju tokena