Az xAI API fejlesztőknek
Ezen az oldalon
É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:
- Egy xAI-fiók, amelyet az accounts.x.ai oldalon hoztál létre
- Egy API-kulcs, amelyet a console.x.ai oldalon generáltál
- Beállított fizetési mód (az ingyenes keret túllépéséhez)
- 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