Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Preprost zahtevek POST /v1/responses

Lekcija 9 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Tvoj prvi uspešen klic
  2. Struktura zahtevka
  3. Anatomija odgovora
  4. Pogosti izbirni parametri
  5. Nadaljevanje pogovora
  6. Sledenje stroškom
  7. Ključne ugotovitve

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_p 0,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š uporabiti
  • input: 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 pridobivanje
  • status: completed, ko je generiranje končano
  • output: polje, ki vsebuje generirana sporočila
  • usage: š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.7 in top_p=0.95 ter 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/responses je najbolj sodobna in najbolj priporočljiva
  • Dva zahtevana parametra: model in input
  • Odgovor najdeš v output[0].content[0].text
  • Za večkratne pogovore uporabi previous_response_id
  • Polje usage ti pomaga slediti porabi žetonov