Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Az xAI API fejlesztőknek

15. lecke 16 közül Frissítve 2026. július 29. Kezdő
Ezen az oldalon
  1. Építsd be a Grokot az alkalmazásaiddba
  2. Előfeltételek
  3. Kezdeti beállítás
  4. Az első kérésed
  5. Mit tesz elérhetővé az API?
  6. Válaszd ki a modelledet!
  7. Sebességkorlátok és legjobb gyakorlatok
  8. Főbb megállapítások

Építsd be a Grokot az alkalmazásaiddba

Minden, amit a Grok felületen megtanultál csinálni, a saját kódodból is elindítható. Az xAI API ezeket a képességeket viszi be az alkalmazásaidba, weboldalaidba és szolgáltatásaiddá: a beszélgetés megszűnik egy hely lenni, ahová mész, és egy függvénnyé válik, amit a terméked hív meg.

Előfeltételek

Négy dologra van szükséged, mielőtt megírnád az első kódsorodat:

  1. Egy xAI-fiók, amelyet az accounts.x.ai oldalon hoztál létre
  2. Egy API-kulcs, amelyet a console.x.ai oldalon generáltál
  3. Beállított fizetési mód (az ingyenes keret túllépéséhez)
  4. Python vagy JavaScript fejlesztői környezet

Az első kettőt már elvégezted ebben a tanfolyamban: a fiók kezeli a hitelesítést, a kulcs pedig azonosítja az alkalmazásodat az API számára. A fizetési módra csak akkor van szükség, ha a használatod meghaladja az ingyenes keretet, ami gyorsabban bekövetkezik, mint gondolnád, amint egy szolgáltatás folyamatosan fut. Ami a környezetet illeti: a Python és a JavaScript rendelkezik a legjobb eszközökkel, de mivel az API HTTP-n kommunikál, bármilyen nyelv megfelel, amelyik képes kérést küldeni.

Kezdeti beállítás

Az első lépés az API-kulcsod biztonságos tárolása egy környezeti változóban:

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

Soha ne építsd be közvetlenül a kulcsot a forráskódba. Az ok banális: egy fájlba írt kulcs előbb-utóbb felkerül egy Git-tárolóba, és egy nyilvános tárolóba feltöltött kulcsot percek alatt kiaknázzák azok a botok, amelyek a commitokat pásztázzák, miközben a számla a te nevedre szól.

Ezután jön az SDK kiválasztása. A natív xAI SDK Pythonhoz a pip install xai-sdk paranccsal telepíthető. Ha a kódod már hívja az OpenAI-t, az openai könyvtár változtatás nélkül működik a formátum-kompatibilitásnak köszönhetően. JavaScript oldalán a Vercel AI SDK-t adod hozzá az npm install ai @ai-sdk/xai paranccsal, amely integrálódik a React és Next.js alkalmazásokkal.

Az első kérésed

A natív SDK-val a kliens létrehozása és egy beszélgetés megnyitása három sorba kerül:

from xai_sdk import Client
import os

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

Az OpenAI-kompatibilis út ugyanilyen közvetlen: csak a base_url változik a meglévő kódhoz képest, ezért váltanak át sokan néhány perc alatt.

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

Hogy még kódírás előtt ellenőrizd, működik-e a kulcs, semmi sem jobb egy parancssori hívásnál:

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

Mit tesz elérhetővé az API?

Az alap a szöveggenerálás (beszélgetés alapú válaszok, írás, elemzés), kiegészítve egy következtetési móddal, amely lépésről lépésre old meg összetett problémákat. A streamelés mindehhez azt adja hozzá, hogy tokenenként szállítja a választ ahelyett, hogy megvárná a generálás végét.

Egy második csoport az információkhoz való hozzáférést biztosítja: valós idejű webes és X-keresés, valamint a RAG, amely az általad felépített dokumentumgyűjteményeket kérdezi le. A multimodális oldal lefedi az általad biztosított képek megértését, a grok-imagine segítségével történő kép- és videógenerálást, valamint a hangot, beleértve a beszélt beszélgetéseket és a szövegfelolvasást (TTS).

Végül három mechanizmus teszi az API-t szigorú értelemben programozhatóvá: a függvényhívás, amely lehetővé teszi, hogy a modell a saját függvényeidet hívja meg; a strukturált kimenetek, amelyek garantálják a használható JSON-t törékeny utófeldolgozás nélkül; valamint a szerveroldali kódvégrehajtás.

Válaszd ki a modelledet!

A következtetési képesség modellenként változik. A grok-4.7, a zászlóshajó, konfigurálható következtetést kínál: a reasoning_effort paraméter (low, medium, high vagy xhigh) állítja be, milyen mélyen gondolkodik, kérésről kérésre. A grok-4.3 továbbra is a költségkímélő, nagyon hosszú kontextusú opció, körülbelül féláron. Léteznek nem következtető verziók is a modelleknek egyszerű feladatokhoz: az átfogalmazáshoz vagy osztályozáshoz nincs szükség belső mérlegelésre.

A elnevezési konvenciók befolyásolják az alkalmazásod stabilitását:

  • grok-4.20: a legújabb ajánlott stabil verzió
  • grok-4.20-latest: a legfrissebb verzió (változhat)
  • grok-4.20-0309: egy adott dátumhoz rögzített verzió (március 9.)

Éles környezetben egy rögzített verzió megvédi a promptjaidat a modell csendes változásaitól; a latest megfelel felfedezésre, feltéve, hogy elfogadod, hogy a viselkedés eltolódhat.

Sebességkorlátok és legjobb gyakorlatok

Az API sebességkorlátokat érvényesít a szolgáltatás stabilitásának érdekében: a belépő szinten körülbelül 10 millió token percenként és 1800 kérés percenként olyan modelleknél, mint a grok-4.3, és ez magasabb lesz, ahogy a szinted emelkedik. A kép- és videógeneráló modelleknek saját, sokkal alacsonyabb korlátaik vannak, modellenként 30–300 kérés percenként, ezért figyeld őket fogyasztói szolgáltatás esetén.

Néhány szokás választja el a prototípust a szilárd integrációtól. Kapcsold be a streamelést hosszú válaszoknál, mert harminc másodperc egy üres képernyő előtt leállásnak tűnik. Adj át beszélgetésazonosítót a gyorsítótárazás előnyeihez. Irányítsd minden feladatot a megfelelő modellhez: a grok-4.3 az egyszerű volumenhez, a grok-4.20 a következtetéshez. Kezeld a hibákat újrapróbálkozásokkal és exponenciális visszalépéssel, különben a forgalomcsúcs elutasított kérések lavinájává válik. És figyeld a használatodat a konzolon, mielőtt a hónap végén szembesülnél a végösszeggel.

Főbb megállapítások

  • Az xAI API kompatibilis az OpenAI formátummal, ami megkönnyíti a migrációt
  • Több SDK is elérhető: natív xAI, OpenAI és a Vercel AI SDK
  • Az API lefedi a szöveget, képeket, videót, hangot és a keresést
  • Két modellszint: grok-4.7 (zászlóshajó, konfigurálható következtetés) és grok-4.3 (költségkímélő, 1M kontextus)
  • Az API-kulcsot mindig környezeti változóban tárold, soha ne legyen beégetve a kódba