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

API xAI pre vývojárov

Lekcia 15 z 16 Aktualizované 29. júla 2026 Začiatočník
Na tejto strane
  1. Zabuduj Grok do svojich aplikácií
  2. Predpoklady
  3. Počiatočné nastavenie
  4. Tvoja prvá požiadavka
  5. Čo API ponúka
  6. Výber modelu
  7. Limity rýchlosti a osvedčené postupy
  8. Kľúčové poznatky

Zabuduj Grok do svojich aplikácií

Všetko, čo si sa naučil robiť v rozhraní Grok, môžeš spustiť priamo zo svojho kódu. API xAI prináša tieto možnosti do tvojich aplikácií, webových stránok a služieb: konverzácia prestáva byť miestom, kam chodíš, a stáva sa funkciou, ktorú volá tvoj produkt.

Predpoklady

Pred napísaním prvého riadku kódu potrebuješ štyri veci:

  1. Účet xAI vytvorený na accounts.x.ai
  2. API kľúč vygenerovaný na console.x.ai
  3. Nastavený spôsob platby (pre prekročenie bezplatného limitu)
  4. Vývojové prostredie pre Python alebo JavaScript

Prvé dve veci si už v tomto kurze urobil: účet slúži na overenie totožnosti a kľúč identifikuje tvoju aplikáciu voči API. Spôsob platby sa použije až v momente, keď tvoje využitie prekročí bezplatný limit, čo sa stane rýchlejšie, než si myslíš, hneď ako služba beží nepretržite. Čo sa týka prostredia, Python a JavaScript majú najlepšie nástroje, ale keďže API komunikuje cez HTTP, stačí akýkoľvek jazyk, ktorý dokáže odoslať požiadavku.

Počiatočné nastavenie

Prvým krokom je bezpečné uloženie tvojho API kľúča do premennej prostredia:

export XAI_API_KEY="xai-your-key-here"

Nikdy neukladaj svoj kľúč priamo do zdrojového kódu. Dôvod je prozaický: kľúč zapísaný v súbore sa skôr či neskôr dostane do Git repozitára a kľúč odoslaný do verejného repozitára zneužijú boty skenujúce commity v priebehu niekoľkých minút, zatiaľ čo účet za služby ostane na tvoje meno.

Ďalším krokom je výber SDK. Natívne SDK xAI pre Python nainštaluješ príkazom pip install xai-sdk. Ak tvoj kód už volá OpenAI, knižnica openai funguje tak, ako je, vďaka kompatibilite formátov. Na strane JavaScriptu pridáš Vercel AI SDK príkazom npm install ai @ai-sdk/xai a integruješ ho s aplikáciami React a Next.js.

Tvoja prvá požiadavka

S natívnym SDK trvá vytvorenie klienta a otvorenie konverzácie tri riadky:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")

Cesta kompatibilná s OpenAI je rovnako priama: mení sa len base_url v porovnaní s existujúcim kódom, čo je dôvod, prečo mnohé tímy prejdú na túto cestu v priebehu niekoľkých minút.

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="Explain machine learning to me in 3 sentences."
)

Ak chceš overiť funkčnosť kľúča ešte pred písaním akéhokoľvek kódu, nič neprekoná volanie z príkazového riadku:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Hi, how are you?"
  }'

Čo API ponúka

Základom je generovanie textu (konverzačné odpovede, písanie, analýza) spolu s režimom uvažovania, ktorý krok za krokom rieši zložité problémy. K tomu pribúda streamovanie, ktoré doručuje odpoveď token po tokene namiesto čakania na dokončenie generovania.

Druhá sada poskytuje prístup k informáciám: vyhľadávanie v reálnom čase na webe a na X a RAG, ktoré dopytuje kolekcie dokumentov, ktoré si vytvoril. Multimodálna stránka pokrýva pochopenie poskytnutých obrázkov, generovanie obrázkov a videí pomocou grok-imagine a hlas, vrátane hovorených konverzácií a TTS.

Nakoniec, tri mechanizmy robia API programovateľným v pravom zmysle slova: volanie funkcií, ktoré umožňuje modelu volať tvoje vlastné funkcie; štruktúrované výstupy, ktoré garantujú použiteľné JSON bez krehkého post-spracovania; a vykonávanie kódu na strane servera.

Výber modelu

Uvažovanie sa líši podľa modelu. grok-4.7, vlajková loď, ponúka konfigurovateľné uvažovanie: parameter reasoning_effort (low, medium, high alebo xhigh) nastavuje hĺbku myslenia pre každú požiadavku zvlášť. grok-4.3 zostáva možnosťou s nízkymi nákladmi a veľmi dlhým kontextom, približne za polovičnú cenu. Existujú aj verzie modelov bez uvažovania určené pre jednoduché úlohy: preformulovanie alebo klasifikácia nepotrebujú vnútorné deliberácie.

Konvencie pomenovania ovplyvňujú stabilitu tvojej aplikácie:

  • grok-4.20: najnovšia odporúčaná stabilná verzia
  • grok-4.20-latest: najnovšia verzia (môže sa meniť)
  • grok-4.20-0309: verzia pripnutá ku konkrétnemu dátumu (9. marec)

V produkcii chráni pripnutá verzia tvoje prompty pred tichými zmenami modelu; latest je v poriadku na prieskum, pokiaľ akceptuješ, že sa správanie môže zmeniť.

Limity rýchlosti a osvedčené postupy

API presadzuje limity rýchlosti, aby udržalo službu stabilnú: na vstupnej úrovni ide o približne 10 miliónov tokenov za minútu a 1 800 požiadaviek za minútu pre modely ako grok-4.3, pričom s vyššou úrovňou tieto limity rastú. Modely na generovanie obrázkov a videí majú vlastné, oveľa nižšie stropy, od 30 do 300 požiadaviek za minútu v závislosti od modelu, takže pri službe určenej koncovým používateľom si na ne daj pozor.

Niekoľko návykov oddeľuje prototyp od pevnej integrácie. Zapni streamovanie pre dlhé odpovede, pretože tridsať sekúnd pred prázdnou obrazovkou pôsobí ako výpadok. Odovzdaj ID konverzácie, aby si využil cache. Smeruj každú úlohu na správny model: grok-4.3 pre jednoduchý objem, grok-4.20 pre uvažovanie. Chyby ošetruj opakovanými pokusmi a exponenciálnym oneskorením, inak sa náraz v premávke zmení na lavínu zamietnutých požiadaviek. A sleduj svoje využitie v konzole, aby si celkovú sumu nezistil až na konci mesiaca.

Kľúčové poznatky

  • API xAI je kompatibilné s formátom OpenAI, čo uľahčuje migráciu
  • K dispozícii je niekoľko SDK: natívne xAI, OpenAI a Vercel AI SDK
  • API pokrýva text, obrázky, video, hlas a vyhľadávanie
  • Dve úrovne modelov: grok-4.7 (vlajková loď, konfigurovateľné uvažovanie) a grok-4.3 (rozpočtová verzia, kontext 1M)
  • API kľúč vždy ukladaj do premennej prostredia, nikdy nie priamo do kódu