SDK-ul Python xAI
Pe această pagină
Actualizat la 3 noiembrie 2026, pe baza celor mai bune practici xAI și a referinței API: temperatura limitată la 1 și recomandată la 0,7. Sursă: Cele mai bune practici. Exemplul de apel urmează README-ul SDK-ului (
chat.append(user(...)),chat.sample(),response.content) și a fost rulat pentru verificare.
SDK-ul oficial Python al xAI
SDK-ul nativ Python al xAI este cea mai directă modalitate de a lucra cu API-ul Grok. Acesta expune funcționalitățile specifice platformei și primește actualizări în premieră atunci când sunt adăugate noi modele sau puncte finale (endpoints).
Instalare
Instalați SDK-ul folosind pip în mediul dumneavoastră Python:
pip install xai-sdk
Recomandăm utilizarea unui mediu virtual pentru a izola dependențele fiecărui proiect:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Inițializarea clientului
Clasa Client este punctul de intrare al SDK-ului. Aceasta gestionează autentificarea, conexiunile HTTP și serializarea cererilor:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Dacă variabila de mediu XAI_API_KEY este setată, puteți crea clientul și fără un argument explicit:
client = Client()
SDK-ul detectează automat variabila și o utilizează pentru autentificare.
Trimiterea unei cereri
Odată clientul inițializat, SDK-ul gândește în termeni de conversații: client.chat.create() creează conversația (fără a trimite nimic), append adaugă un mesaj construit cu user() sau system(), iar sample() solicită modelului răspunsul său:
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("Explică ce este un API REST în 3 propoziții."))
response = chat.sample()
print(response.content)
Parametri comuni
model: ID-ul modelului de utilizat (obligatoriu); xAI recomandăgrok-4.7messages: mesajele inițiale ale conversației, construite cusystem(),user()șiassistant()dinxai_sdk.chat(dicționarele simple vor face ca apelul să eșueze)temperature: de la 0 la 2, limitat la 1 peste această valoare; xAI recomandă 0,7, cutop_pla 0,95max_tokens: numărul maxim de tokeni generațireasoning_effort: profunzimea raționamentului (none,low,medium,high), pe care xAI recomandă să o setați la fiecare cerere
Streaming-ul nu trece printr-un parametru: for response, chunk in chat.stream(): returnează fragmentele pe măsură ce sosesc în chunk.content. Lecția 10 prezintă streaming-ul cu API-ul REST, prin SSE.
Avantajele SDK-ului nativ
Comparativ cu SDK-ul OpenAI orientat către API-ul xAI (lecția următoare), SDK-ul nativ oferă acces direct la funcționalitățile specifice xAI: căutare pe X și web, instrumente lato-server (server-side), generare video, colecții de documente. Tipurile sale complete Python potențează autocompletarea editorului dumneavoastră, iar xAI îl menține în pas cu API-ul. De asemenea, are propria sa structură, pe care trebuie să o acceptați: rulează peste gRPC, mesajele sunt construite cu user() și system(), iar erorile sunt de tip grpc.RpcError.
Când să alegeți acest SDK
Alegerea decurge natural din situația dumneavoastră. Pentru un proiect nou construit specific pe API-ul Grok, SDK-ul nativ este punctul de plecare evident: obțineți tot ce s-a menționat mai sus fără constrângeri de compatibilitate de respectat. Acesta devine esențial imediat ce planificați utilizarea funcționalităților specifice xAI, cum ar fi căutarea pe X sau căutarea web integrată, care funcționează pe deplin doar în acest mod. Dacă, pe de altă parte, aveți cod existent construit pe SDK-ul OpenAI, nu rescrieți nimic deocamdată: lecția următoare arată cum să îl adaptați modificând două linii.
Puncte cheie
- Instalați cu
pip install xai-sdkîntr-un mediu virtual - Clasa
Clienteste punctul de intrare, cu detectare automată aXAI_API_KEY client.chat.create()creează o conversație;chat.append(user(...))adaugă un mesaj, iarchat.sample()returnează răspunsul, citit dinresponse.content- Preferați acest SDK pentru proiectele noi care vizează exclusiv API-ul Grok