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

Vytvorenie odpovede pomocou POST /v1/responses

Lekcia 2 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Tvoja prvá požiadavka
  2. Autentifikácia
  3. Minimálna požiadavka
  4. Pomocou Python SDK
  5. Jednoduchý vs. štruktúrovaný vstup
  6. Parameter instructions
  7. Praktické cvičenie
  8. Kľúčové poznatky

Tvoja prvá požiadavka

Koncový bod POST /v1/responses je hlavným vstupným bodom pre API odpovedí (Responses API). Sem odosielaš svoje výzvy (prompty) a dostávaš odpovede od modelov Grok. V tejto lekcii sa naučíš, ako zostaviť a odoslať svoju prvú požiadavku.

Autentifikácia

Všetky požiadavky vyžadujú hlavičku autentifikácie s tvojím kľúčom xAI API:

Authorization: Bearer $XAI_API_KEY

Svoje kľúče si môžeš vygenerovať na console.x.ai. Uchovávaj ich v tajnosti – nikdy ich neodosielaj do repozitára Git.

Minimálna požiadavka

Tu je úplne najjednoduchšia možná požiadavka:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "input": "Explain what machine learning is in 3 sentences."
  }'

Stačia dve polia:

  • model: identifikátor modelu Grok, ktorý chceš použiť
  • input: tvoja výzva ako obyčajný text

Pomocou Python SDK

Ak používaš OpenAI SDK (kompatibilné s xAI), syntax je podobná:

from openai import OpenAI

client = OpenAI(
    api_key="xai-...",
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Explain what machine learning is in 3 sentences."
)

print(response.output[0].content[0].text)

Jednoduchý vs. štruktúrovaný vstup

Parameter input akceptuje dva formáty.

Obyčajný text

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What is the capital of France?"
}

Štruktúrované pole

Pre multimodálne vstupy alebo explicitné určenie rolí:

{
  "model": "grok-4.20-0309-reasoning",
  "input": [
    {
      "role": "user",
      "content": "Analyze this image and describe what you see."
    }
  ]
}

Formát poľa ti dáva väčšiu kontrolu, najmä pri vkladaní obrázkov alebo určovaní rôznych rolí.

Parameter instructions

Ak chceš modelu definovať systémové správanie, použi parameter instructions namiesto pridávania systémovej správy do input:

{
  "model": "grok-4.20-0309-reasoning",
  "instructions": "You are a French cuisine expert. Always respond including a chef's tip.",
  "input": "How do I make a successful béchamel?"
}

Pole instructions je ekvivalentom „systémového promptu“ (system prompt) v Chat Completions. Definuje celkové správanie modelu pre celú konverzáciu.

Praktické cvičenie

Skús zostaviť požiadavku, ktorá:

  1. Používa model grok-4.20-0309-reasoning
  2. Definuje systémové inštrukcie pre technického asistenta
  3. Kladie otázku týkajúcu sa Pythonu
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "instructions": "You are a senior Python developer. Give concise code examples.",
    "input": "How do I read a JSON file in Python?"
  }'

Kľúčové poznatky

  • POST /v1/responses je hlavný koncový bod – vyžaduje parametre model a input
  • input akceptuje obyčajný text alebo štruktúrované pole s rolami
  • instructions definuje systémové správanie modelu
  • Autentifikácia prebieha prostredníctvom hlavičky Authorization: Bearer
  • OpenAI SDK je kompatibilné s xAI po zmene parametra base_url