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

API xAI pro vývojáře

Lekce 15 z 16 Aktualizováno 29. července 2026 Začátečník
Na této stránce
  1. Zabuduj Groka do svých aplikací
  2. Předpoklady
  3. Počáteční nastavení
  4. Tvůj první požadavek
  5. Co API nabízí
  6. Výběr modelu
  7. Limity rychlosti a osvědčené postupy
  8. Klíčové poznatky

Zabuduj Groka do svých aplikací

Všechno, co ses naučil dělat v rozhraní Grok, můžeš spustit přímo ze svého kódu. API xAI přenáší tyto schopnosti do tvých aplikací, webů a služeb: konverzace přestává být místem, kam chodíš, a stává se funkcí, kterou volá tvůj produkt.

Předpoklady

Než napíšeš první řádek kódu, potřebuješ čtyři věci:

  1. Účet xAI založený na accounts.x.ai
  2. API klíč vygenerovaný na console.x.ai
  3. Nastavenou platební metodu (pro překročení bezplatného limitu)
  4. Vývojové prostředí pro Python nebo JavaScript

První dvě věci jsi v tomto kurzu už udělal: účet řeší ověření a klíč identifikuje tvou aplikaci vůči API. Platební metoda přijde na řadu až ve chvíli, kdy tvoje využití překročí bezplatný limit, k čemuž dojde rychleji, než bys čekal, jakmile služba běží nepřetržitě. Co se týče prostředí, Python a JavaScript mají nejlepší nástroje, ale protože API komunikuje přes HTTP, stačí jakýkoli jazyk, který umí odeslat požadavek.

Počáteční nastavení

Prvním krokem je bezpečné uložení API klíče do proměnné prostředí:

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

Nikdy neukládej klíč přímo do zdrojového kódu. Důvod je prozaický: klíč zapsaný v souboru se dříve či později ocitne v Git repozitáři a klíč nahraný do veřejného repozitáře během minut využijí boti skenující commity, zatímco účet za škody zůstane tobě.

Dalším krokem je výběr SDK. Natívní SDK xAI pro Python nainstaluješ příkazem pip install xai-sdk. Pokud tvůj kód již volá OpenAI, knihovna openai funguje tak, jak je, díky kompatibilitě formátu. Na straně JavaScriptu přidáš Vercel AI SDK pomocí npm install ai @ai-sdk/xai a ono se integruje s aplikacemi React a Next.js.

Tvůj první požadavek

S natívním SDK zabere vytvoření klienta a otevření konverzace tři řádky:

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 stejně přímá: oproti existujícímu kódu se mění pouze base_url, což je důvod, proč mnoho týmů přejde během několika minut.

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."
)

Chceš-li ověřit funkčnost klíče ještě před psaním kódu, nic nepředčí volání z příkazové řádky:

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?"
  }'

Co API nabízí

Základem je generování textu (konverzační odpovědi, psaní, analýza) spolu s režimem uvažování, který krok za krokem řeší složité problémy. K tomu přibývá streamování, které doručuje odpověď token po tokenu, místo aby čekalo na dokončení generování.

Druhá sada poskytuje přístup k informacím: vyhledávání v reálném čase na webu a na síti X a RAG, které dotazuje kolekce dokumentů, které jsi vytvořil. Multimodální stránka pokrývá porozumění obrázkům, které poskytneš, generování obrázků a videí pomocí grok-imagine a hlasovou komunikaci s mluvenými konverzacemi a TTS.

Nakonec tři mechanismy činí API programovatelným v pravém slova smyslu: volání funkcí, které modelu umožňuje volat tvé vlastní funkce; strukturované výstupy, které garantují použitelné JSON bez křehkého post-processingu; a provádění kódu na straně serveru.

Výběr modelu

Uvažování se liší podle modelu. grok-4.7, vlajková loď, nabízí konfigurovatelné uvažování: parametr reasoning_effort (low, medium, high nebo xhigh) nastavuje, jak hluboce model přemýšlí, žádost po žádosti. grok-4.3 zůstává rozpočtovou možností s velmi dlouhým kontextem, zhruba za poloviční cenu. Existují i verze modelů bez uvažování pro jednoduché úkoly: přeformulování nebo klasifikace nepotřebují vnitřní deliberaci.

Konvence pojmenování ovlivňují stabilitu tvé aplikace:

  • grok-4.20: nejnovější doporučená stabilní verze
  • grok-4.20-latest: nejnovější verze (může se měnit)
  • grok-4.20-0309: verze připnutá ke konkrétnímu datu (9. března)

V produkci chrání připnutá verze tvé prompty před tichými změnami modelu; latest je v pořádku pro průzkum, pokud přijmeš, že se chování může změnit.

Limity rychlosti a osvědčené postupy

API vynucuje limity rychlosti, aby udrželo službu stabilní: na vstupní úrovni jde o zhruba 10 milionů tokenů za minutu a 1 800 požadavků za minutu pro modely jako grok-4.3, s rostoucí úrovní se tyto limity zvyšují. Modely pro generování obrázků a videí mají vlastní, mnohem nižší stropy, od 30 do 300 požadavků za minutu v závislosti na modelu, takže u služeb určených koncovým uživatelům je sleduj.

Několik návyků odděluje prototyp od solidní integrace. Zapni streamování u dlouhých odpovědí, protože třicet sekund před prázdnou obrazovkou působí jako výpadek. Předej ID konverzace, abys využil cache. Směruj každý úkol na správný model: grok-4.3 pro jednoduchý objem, grok-4.20 pro uvažování. Chyby řeš opakovanými pokusy a exponenciálním backoffem, jinak se špička provozu změní v lavinu odmítnutých požadavků. A sleduj své využití v konzoli, abys celkovou částku nezjistil až na konci měsíce.

Klíčové poznatky

  • API xAI je kompatibilní s formátem OpenAI, což usnadňuje migraci
  • K dispozici je několik SDK: nativní xAI, OpenAI a Vercel AI SDK
  • API pokrývá text, obrázky, video, hlas a vyhledávání
  • Dvě úrovně modelů: grok-4.7 (vlajková loď, konfigurovatelné uvažování) a grok-4.3 (rozpočtový, kontext 1M)
  • API klíč vždy ukládej do proměnné prostředí, nikdy ho neukládej přímo do kódu