Salt la conținutul principal
Română— Alege o limbă
Meniu

SDK-ul Python xAI

Lecția 5 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. SDK-ul oficial Python al xAI
  2. Instalare
  3. Inițializarea clientului
  4. Trimiterea unei cereri
  5. Avantajele SDK-ului nativ
  6. Când să alegeți acest SDK
  7. Puncte cheie

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

pip
Instalare standard
Client
Clasa principală
Auto
Detectare cheie API
Nativ
Suport complet xAI

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.7
  • messages: mesajele inițiale ale conversației, construite cu system(), user() și assistant() din xai_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, cu top_p la 0,95
  • max_tokens: numărul maxim de tokeni generați
  • reasoning_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 Client este punctul de intrare, cu detectare automată a XAI_API_KEY
  • client.chat.create() creează o conversație; chat.append(user(...)) adaugă un mesaj, iar chat.sample() returnează răspunsul, citit din response.content
  • Preferați acest SDK pentru proiectele noi care vizează exclusiv API-ul Grok