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

Az xAI Python SDK

5. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Az xAI hivatalos Python SDK-ja
  2. Telepítés
  3. A kliens inicializálása
  4. Kérés küldése
  5. A natív SDK előnyei
  6. Mikor válaszd ezt az SDK-t?
  7. Főbb megállapítások

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á.

pip
Szabványos telepítés
Kliens
Fő osztály
Auto
API-kulcs észlelése
Natív
Teljes xAI támogatás

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 a grok-4.7 modellt ajánlja
  • messages: a beszélgetés kezdőüzenetei, amelyeket a xai_sdk.chat modulból származó system(), user() és assistant() 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, a top_p értékét pedig 0,95-re
  • max_tokens: a generálható tokenek maximális száma
  • reasoning_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-sdk paranccsal egy virtuális környezetben
  • A Client osztály a belépési pont, amely automatikusan észleli a XAI_API_KEY változót
  • A client.chat.create() létrehoz egy beszélgetést; a chat.append(user(...)) hozzáad egy üzenetet, a chat.sample() pedig visszaadja a választ, amelyet a response.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