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

API xAI a kompatibilita s OpenAI

Lekcia 4 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Známe API
  2. Minimálna konfigurácia
  3. Získanie API kľúča
  4. Dostupné koncové body
  5. Obmedzenia kompatibility
  6. Kľúčové poznatky

Známe API

API xAI používa rovnaký formát ako API OpenAI. Ak si už pracoval s API OpenAI alebo kompatibilnými nástrojmi, nemusíš sa učiť nič nové. Mení sa iba základná URL adresa.

https://api.x.ai/v1

Táto kompatibilita je strategickou voľbou spoločnosti xAI. Namiesto zavádzania nového proprietárneho formátu prijali de facto priemyselný štandard. Výsledkom je, že akýkoľvek nástroj, SDK alebo editor podporujúci API OpenAI môže okamžite využívať model grok-build-0.1.

Minimálna konfigurácia

Ak chceš v akomkoľvek kompatibilnom klientovi prepnúť z OpenAI na xAI, musíš zmeniť iba dva parametre:

  1. Základná URL: nahraď https://api.openai.com/v1 adresou https://api.x.ai/v1
  2. API kľúč: použij svoj API kľúč xAI (získaný z console.x.ai)

Všetko ostatné – formát správ, parametre teploty, štruktúra odpovede – zostáva identické.

Príklad s Python SDK pre OpenAI

from openai import OpenAI

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

response = client.chat.completions.create(
    model="grok-build-0.1",
    messages=[
        {"role": "system", "content": "You are a programming assistant."},
        {"role": "user", "content": "Write a quicksort function in Python."}
    ]
)

Štandardné SDK OpenAI používaš bez akýchkoľvek úprav. Mení sa iba base_url a názov modelu.

Príklad s curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer your-xai-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-build-0.1",
    "messages": [
      {"role": "user", "content": "Explain the difference between let and const in JavaScript"}
    ]
  }'

Získanie API kľúča

  1. Prejdi na console.x.ai
  2. Prihlás sa pomocou svojho účtu xAI (alebo si vytvor nový na accounts.x.ai)
  3. V sekcii API Keys vygeneruj nový kľúč
  4. Okamžite si ho skopíruj – už sa ti znova nezobrazí

Tento kľúč uchovávaj v bezpečí. Nikdy ho neodosielaj do Git repozitára ani ho nezdieľaj v tímovom chate. Použi premennú prostredia alebo správcu tajných údajov.

Dostupné koncové body

Model grok-build-0.1 podporuje nasledujúce koncové body, všetky vo formáte OpenAI:

  • /v1/chat/completions: generovanie textu a kódu (najpoužívanejšie)
  • /v1/chat/completions s stream: true: streamovanie s reasoning_content
  • /v1/chat/completions s tools: natívne volanie nástrojov

Obmedzenia kompatibility

Existuje niekoľko drobných rozdielov:

  • Dostupné modely sú od xAI (grok-build-0.1, grok-4.5 atď.), nie od OpenAI
  • Niektoré parametre špecifické pre OpenAI (ako napríklad logprobs) nemusia byť podporované
  • reasoning_content je špecifické pre API xAI a v API OpenAI neexistuje

Kľúčové poznatky

  • API xAI sa nachádza na adrese https://api.x.ai/v1 a je kompatibilné s formátom OpenAI
  • Na migráciu stačí zmeniť základnú URL a API kľúč
  • Python SDK pre OpenAI funguje bez úprav
  • API kľúč získaš na console.x.ai
  • Všetky editory kompatibilné s OpenAI fungujú aj s xAI