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

Vytvoření odpovědi pomocí POST /v1/responses

Lekce 2 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Tvůj první požadavek
  2. Autentizace
  3. Minimální požadavek
  4. S použitím Python SDK
  5. Prostý text versus strukturovaný vstup
  6. Parametr instructions
  7. Praktické cvičení
  8. Klíčové poznatky

Tvůj první požadavek

Koncový bod POST /v1/responses je hlavním vstupním bodem pro API odpovědí (Responses API). Právě sem odesíláš své prompty a přijímáš odpovědi od modelů Grok. V této lekci se naučíš, jak sestavit a odeslat svůj první požadavek.

Autentizace

Všechny požadavky vyžadují hlavičku pro autentizaci s tvým API klíčem xAI:

Authorization: Bearer $XAI_API_KEY

Své klíče si můžeš vygenerovat na console.x.ai. Uchovávej je v tajnosti – nikdy je necommituj do Git repozitáře.

Minimální požadavek

Zde je úplně nejjednodušší možný požadavek:

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čí dvě pole:

  • model: ID modelu Grok, který chceš použít
  • input: tvůj prompt jako prostý text

S použitím Python SDK

Pokud používáš OpenAI SDK (kompatibilní s xAI), syntaxe je velmi 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)

Prostý text versus strukturovaný vstup

Parametr input přijímá dva formáty.

Prostý text

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

Strukturované pole

Pro multimodální vstupy nebo explicitní definici rolí:

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

Formát pole ti dává větší kontrolu, zejména když potřebuješ zahrnout obrázky nebo určit různé role.

Parametr instructions

Chceš-li modelu definovat systémové chování, použij instructions místo přidávání systémové zprávy přímo 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 odpovídá „system prompt“ v Chat Completions. Definuje celkové chování modelu pro celou konverzaci.

Praktické cvičení

Zkus sestavit požadavek, který:

  1. Používá model grok-4.20-0309-reasoning
  2. Definuje systémové instrukce pro technického asistenta
  3. Klade otázku týkající se 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?"
  }'

Klíčové poznatky

  • POST /v1/responses je hlavní koncový bod – vyžaduje model a input
  • input přijímá prostý text nebo strukturované pole s rolemi
  • instructions definuje systémové chování modelu
  • Autentizace probíhá prostřednictvím hlavičky Authorization: Bearer
  • OpenAI SDK je kompatibilní s xAI po změně base_url