Przejdź do głównej treści
Polski— Wybierz język
Menu

Python SDK od xAI

Lekcja 5 z 14 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Oficjalne Python SDK od xAI
  2. Instalacja
  3. Inicjalizacja klienta
  4. Wysyłanie żądania
  5. Zalety natywnego SDK
  6. Kiedy wybrać to SDK
  7. Kluczowe wnioski

Zaktualizowano 3 listopada 2026 r. na podstawie najlepszych praktyk xAI i dokumentacji API: parametr temperature ograniczony 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.

pip
Standardowa instalacja
Client
Główna klasa
Auto
Wykrywanie klucza API
Natywne
Pełne wsparcie xAI

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 rekomenduje grok-4.7
  • messages: początkowe wiadomości konwersacji, budowane za pomocą system(), user() i assistant() z xai_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 przy top_p ustawionym na 0,95
  • max_tokens: maksymalna liczba generowanych tokenów
  • reasoning_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-sdk w środowisku wirtualnym
  • Klasa Client jest punktem wejścia z automatycznym wykrywaniem XAI_API_KEY
  • client.chat.create() tworzy konwersację; chat.append(user(...)) dodaje wiadomość, a chat.sample() zwraca odpowiedź odczytywaną z response.content
  • Wybierz to SDK dla nowych projektów celujących wyłącznie w API Grok