Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Jednoduchý požadavek POST /v1/responses

Lekce 9 z 14 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Tvůj první úspěšný požadavek
  2. Struktura požadavku
  3. Anatomie odpovědi
  4. Běžné volitelné parametry
  5. Pokračování v konverzaci
  6. Sledování nákladů
  7. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě osvědčených postupů xAI a reference k API: teplota je omezena na hodnotu 1 a xAI doporučuje 0,7 s parametrem top_p nastaveným na 0,95. Zdroj: Osvědčené postupy.

Tvůj první úspěšný požadavek

Máš založený účet, máš API klíč a nainstalované SDK. Je čas odeslat svůj první požadavek na Grok API a pochopit strukturu odpovědi. Tato lekce se zaměřuje na hlavní koncový bod /v1/responses, který je nejmodernější a nejvíce doporučovaný.

Struktura požadavku

Koncový bod POST /v1/responses vyžaduje alespoň dva parametry:

  • model: ID modelu, který chceš použít
  • input: text tvého požadavku (nebo pole obsahu pro pokročilé případy)

Minimální požadavek 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)

Se systémovými instrukcemi

Parametr instructions ti umožňuje definovat chování 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?"
)

Anatomie odpovědi

API vrací strukturovaný objekt JSON. Zde jsou hlavní pole:

{
  "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á pole

  • id: unikátní ID odpovědi, užitečné pro její pozdější získání
  • status: completed, když je generování dokončeno
  • output: pole obsahující vygenerované zprávy
  • usage: počítadla tokenů pro sledování tvé spotřeby

Běžné volitelné parametry

Řízení kreativity

response = client.responses.create(
    model="grok-4.5",
    input="Suggest a name for an AI startup.",
    temperature=0.7,  # hodnota doporučená xAI
    top_p=0.95,
)
  • API přijímá teplotu v rozmezí od 0 do 2, ale jakoukoli vyšší hodnotu omezí na 1
  • xAI doporučuje temperature=0.7 a top_p=0.95 a radí se od nich neodchýlit: kvalita obvykle klesá
  • Pro větší kreativitu o ni požádej přímo v promptu („navrhni nečekané názvy“)

Omezení délky

response = client.responses.create(
    model="grok-4.5",
    input="Summarize the concept of machine learning.",
    max_output_tokens=200  # Omezí délku odpovědi
)

Zapnutí uvažování

U modelů zaměřených na uvažování uprav úsilí věnované myšlení:

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é úrovně jsou low, medium a high.

Pokračování v konverzaci

Koncový bod /v1/responses podporuje vícekolové konverzace prostřednictvím parametru previous_response_id:

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

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

Tento přístup je jednodušší než ruční správa historie zpráv.

Sledování nákladů

Pole usage v odpovědi ti umožňuje vypočítat náklady na každé volání. Pole output_tokens_details.reasoning_tokens ukazuje, kolik tokenů bylo spotřebováno na interní uvažování modelu (tyto tokeny jsou zpoplatněny, ale v odpovědi se nezobrazují).

Klíčové poznatky

  • Koncový bod POST /v1/responses je nejmodernější a nejvíce doporučovaný
  • Dva povinné parametry: model a input
  • Odpověď najdeš v output[0].content[0].text
  • Pro vícekolové konverzace použij previous_response_id
  • Pole usage ti pomáhá sledovat spotřebu tokenů