Python SDK od xAI
Na tej stronie
Zaktualizowano 3 listopada 2026 r. na podstawie najlepszych praktyk xAI i dokumentacji API: parametr
temperatureograniczony do 1, zalecana wartość to 0,7. Źródło: Najlepsze praktyki. Przykład wywołania opiera się na README SDK (chat.append(user(...)),chat.sample(),response.content) i został przetestowany w celu weryfikacji.
Oficjalne Python SDK od xAI
Natywne SDK Python od xAI to najbardziej bezpośredni sposób pracy z API Grok. Udostępnia ono specyficzne funkcje platformy i otrzymuje aktualizacje jako pierwsze, gdy dodawane są nowe modele lub punkty końcowe.
Instalacja
Zainstaluj SDK za pomocą pip w swoim środowisku Python:
pip install xai-sdk
Zalecamy użycie środowiska wirtualnego, aby odizolować zależności każdego projektu:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Inicjalizacja klienta
Klasa Client jest punktem wejścia SDK. Obsługuje ona uwierzytelnianie, połączenia HTTP oraz serializację żądań:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Jeśli zmienna środowiskowa XAI_API_KEY jest ustawiona, możesz utworzyć klienta również bez podawania jawnego argumentu:
client = Client()
SDK automatycznie wykrywa tę zmienną i używa jej do uwierzytelniania.
Wysyłanie żądania
Po zainicjalizowaniu klienta, SDK operuje w oparciu o konwersacje: client.chat.create() tworzy konwersację (nie wysyłając jeszcze niczego), append dodaje wiadomość zbudowaną za pomocą user() lub system(), a sample() prosi model o odpowiedź:
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("Wyjaśnij, czym jest API REST, w 3 zdaniach."))
response = chat.sample()
print(response.content)
Typowe parametry
model: identyfikator modelu do użycia (wymagany); xAI rekomendujegrok-4.7messages: początkowe wiadomości konwersacji, budowane za pomocąsystem(),user()iassistant()zxai_sdk.chat(zwykłe słowniki spowodują niepowodzenie wywołania)temperature: od 0 do 2, powyżej tej wartości ograniczone do 1; xAI zaleca 0,7 przytop_pustawionym na 0,95max_tokens: maksymalna liczba generowanych tokenówreasoning_effort: głębokość rozumowania (none,low,medium,high), którą xAI zaleca ustawiać w każdym żądaniu
Strumieniowanie nie odbywa się przez parametr: pętla for response, chunk in chat.stream(): zwraca fragmenty w miarę ich otrzymywania w chunk.content. Lekcja 10 pokazuje strumieniowanie przez API REST przy użyciu SSE.
Zalety natywnego SDK
W porównaniu z SDK OpenAI skierowanym na API xAI (następna lekcja), natywne SDK zapewnia bezpośredni dostęp do funkcji specyficznych dla xAI: wyszukiwania w X i sieci, narzędzi po stronie serwera, generowania wideo oraz kolekcji dokumentów. Jego kompletne typy Python wspierają autouzupełnianie w Twoim edytorze, a xAI utrzymuje je w tempie rozwoju API. Ma ono również swoją własną strukturę, którą musisz zaakceptować: działa przez gRPC, jego wiadomości buduje się za pomocą user() i system(), a błędy to grpc.RpcError.
Kiedy wybrać to SDK
Wybór wynika naturalnie z Twojej sytuacji. W przypadku nowego projektu budowanego specyficznie pod API Grok, natywne SDK jest oczywistym punktem startowym: otrzymujesz wszystkie wymienione wyżej korzyści bez konieczności przestrzegania ograniczeń kompatybilności. Staje się ono niezbędne, gdy planujesz korzystać z funkcji specyficznych dla xAI, takich jak wyszukiwanie w X czy wbudowane wyszukiwanie w sieci, które działają w pełni tylko w ten sposób. Jeśli natomiast posiadasz istniejący kod oparty na SDK OpenAI, nie przepisuj go na razie: następna lekcja pokaże, jak go dostosować, zmieniając zaledwie dwie linijki.
Kluczowe wnioski
- Zainstaluj za pomocą
pip install xai-sdkw środowisku wirtualnym - Klasa
Clientjest punktem wejścia z automatycznym wykrywaniemXAI_API_KEY client.chat.create()tworzy konwersację;chat.append(user(...))dodaje wiadomość, achat.sample()zwraca odpowiedź odczytywaną zresponse.content- Wybierz to SDK dla nowych projektów celujących wyłącznie w API Grok