Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Jednoduchá požiadavka POST /v1/responses

Lekcia 9 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Tvoj prvý úspešný volanie
  2. Štruktúra požiadavky
  3. Anatómia odpovede
  4. Bežné voliteľné parametre
  5. Pokračovanie v konverzácii
  6. Sledovanie nákladov
  7. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe osvedčených postupov xAI a referencie API: hodnota teploty je obmedzená na 1 a xAI odporúča 0,7 s top_p nastaveným na 0,95. Zdroj: Osvedčené postupy.

Tvoj prvý úspešný volanie

Máš svoj účet, svoj API kľúč a nainštalované SDK. Je čas odoslať tvoju prvú požiadavku do API Grok a pochopiť štruktúru odpovede. Táto lekcia sa zameriava na hlavný koncový bod /v1/responses, ktorý je najmodernejší a najviac odporúčaný.

Štruktúra požiadavky

Koncový bod POST /v1/responses vyžaduje aspoň dva parametre:

  • model: ID modelu, ktorý chceš použiť
  • input: text tvojej požiadavky (alebo pole obsahu pre pokročilé prípady)

Minimálna požiadavka v Pythone

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)

So systémovými inštrukciami

Parameter instructions ti umožňuje definovať správanie 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?"
)

Anatómia odpovede

API vráti štruktúrovaný objekt JSON. Tu sú hlavné polia:

{
  "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é polia

  • id: jedinečné ID odpovede, užitočné na jej neskoršie získanie
  • status: completed, keď je generovanie dokončené
  • output: pole obsahujúce vygenerované správy
  • usage: počítadlá tokenov na sledovanie tvojej spotreby

Bežné voliteľné parametre

Kontrola kreativity

response = client.responses.create(
    model="grok-4.5",
    input="Suggest a name for an AI startup.",
    temperature=0.7,  # hodnota odporúčaná xAI
    top_p=0.95,
)
  • API akceptuje teplotu od 0 do 2, ale akúkoľvek vyššiu hodnotu oreže na 1
  • xAI odporúča temperature=0.7 a top_p=0.95 a neodporúča sa od nich odchyľovať: kvalita zvyčajne klesá
  • Pre viac kreativity o ňu požiadaj priamo v promte („navrhni nečakané názvy“)

Obmedzenie dĺžky

response = client.responses.create(
    model="grok-4.5",
    input="Summarize the concept of machine learning.",
    max_output_tokens=200  # Obmedzí odpoveď
)

Zapnutie uvažovania

Pre modely s uvažovaním uprav úsilie o myslenie:

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é úrovne sú low, medium a high.

Pokračovanie v konverzácii

Koncový bod /v1/responses podporuje viacnásobné konverzácie prostredníctvom parametra previous_response_id:

# Prvá správa
r1 = client.responses.create(
    model="grok-4.5",
    input="I'm building an API in Python."
)

# Druhá správa (model si pamätá kontext)
r2 = client.responses.create(
    model="grok-4.5",
    input="Which framework do you recommend?",
    previous_response_id=r1.id
)

Tento prístup je jednoduchší ako ručné spravovanie histórie správ.

Sledovanie nákladov

Pole usage v odpovedi ti umožňuje vypočítať náklady na každé volanie. Pole output_tokens_details.reasoning_tokens ukazuje, koľko tokenov išlo do interného uvažovania modelu (tieto tokeny sa účtujú, ale nezobrazujú sa v odpovedi).

Kľúčové poznatky

  • Koncový bod POST /v1/responses je najmodernejší a najviac odporúčaný
  • Dva požadované parametre: model a input
  • Odpoveď nájdeš v output[0].content[0].text
  • Na viacnásobné konverzácie použi previous_response_id
  • Pole usage ti pomáha sledovať spotrebu tokenov