Az xAI Python SDK
Ezen az oldalon
Frissítve: 2026. november 3., az xAI legjobb gyakorlatai és API-referenciája alapján: a hőmérséklet (temperature) maximális értéke 1, az ajánlott érték pedig 0,7. Forrás: Legjobb gyakorlatok. A hívási példa az SDK README fájlt követi (
chat.append(user(...)),chat.sample(),response.content), és lefuttattuk a ellenőrzéshez.
Az xAI hivatalos Python SDK-ja
Az xAI natív Python SDK-ja a legközvetlenebb módja a Grok API használatának. Ez teszi elérhetővé a platform specifikus funkcióit, és ez kapja meg elsőként a frissítéseket, amikor új modelleket vagy végpontokat adnak hozzá.
Telepítés
Telepítsd az SDK-t a pip segítségével a Python környezetedben:
pip install xai-sdk
Javasoljuk egy virtuális környezet használatát, hogy elkülönítsd az egyes projektek függőségeit:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
A kliens inicializálása
A Client osztály az SDK belépési pontja. Ez kezeli a hitelesítést, a HTTP-kapcsolatokat és a kérések sorosítását:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Ha be van állítva a XAI_API_KEY környezeti változó, a klienst explicit argumentum nélkül is létrehozhatod:
client = Client()
Az SDK automatikusan észleli a változót, és felhasználja azt a hitelesítéshez.
Kérés küldése
Miután inicializáltad a klienst, az SDK beszélgetésekben gondolkodik: a client.chat.create() létrehozza a beszélgetést (anélkül, hogy bármit is elküldene), az append hozzáad egy üzenetet, amelyet a user() vagy system() függvénnyel építesz fel, a sample() pedig választ kér a modelltől:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(model="grok-4.7")
chat.append(user("Magyarázd el 3 mondatban, mi az a REST API."))
response = chat.sample()
print(response.content)
Gyakori paraméterek
model: a használni kívánt modell azonosítója (kötelező); az xAI agrok-4.7modellt ajánljamessages: a beszélgetés kezdőüzenetei, amelyeket axai_sdk.chatmodulból származósystem(),user()ésassistant()függvényekkel építesz fel (a sima szótárak miatt a hívás sikertelen lesz)temperature: 0 és 2 közötti érték, efelett 1-ben maximalizálva; az xAI a 0,7-es értéket ajánlja, atop_pértékét pedig 0,95-remax_tokens: a generálható tokenek maximális számareasoning_effort: a következtetés mélysége (none,low,medium,high), amelyet az xAI minden kérésnél beállítani javasol
A streamelés nem paraméteren keresztül történik: a for response, chunk in chat.stream(): ciklus a töredékeket adja vissza, ahogy azok megérkeznek a chunk.content változóban. A 10. lecke az SSE-n keresztüli streamelést mutatja be a REST API-val.
A natív SDK előnyei
Az xAI API-ra irányított OpenAI SDK-hoz képest (amit a következő leckében tárgyalunk), a natív SDK közvetlen hozzáférést biztosít az xAI-specifikus funkciókhoz: X és webes keresés, szerveroldali eszközök, videógenerálás, dokumentumgyűjtemények. A teljes körű Python típusok segítik a szerkesztőd automatikus kiegészítését, és az xAI tartja karban az API fejlődési ütemével összhangban. Saját felépítéssel is rendelkezik, amit el kell fogadnod: gRPC-n fut, az üzeneteit a user() és system() függvényekkel építed fel, a hibái pedig grpc.RpcError típusúak.
Mikor válaszd ezt az SDK-t?
A választás természetesen adódik a helyzetedből. Egy kifejezetten a Grok API-ra épülő új projekt esetén a natív SDK a kézenfekvő kiindulópont: minden fenti előnyt megkapsz kompatibilitási kényszerek nélkül. Akkor válik nélkülözhetetlenné, ha xAI-specifikus funkciókat, például X-keresést vagy beépített webes keresést tervezel használni, mivel ezek csak így működnek teljes körűen. Ha viszont már rendelkezel az OpenAI SDK-ra épülő meglévő kóddal, ne írj át semmit egyelőre: a következő lecke bemutatja, hogyan illesztheted azt két sor módosításával.
Főbb megállapítások
- Telepítsd a
pip install xai-sdkparanccsal egy virtuális környezetben - A
Clientosztály a belépési pont, amely automatikusan észleli aXAI_API_KEYváltozót - A
client.chat.create()létrehoz egy beszélgetést; achat.append(user(...))hozzáad egy üzenetet, achat.sample()pedig visszaadja a választ, amelyet aresponse.contentből olvashatsz ki - Új projekteknél, amelyek kizárólag a Grok API-t célozzák meg, ezt az SDK-t részesítsd előnyben