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

API xAI dla programistów

Lekcja 15 z 16 Zaktualizowano 29 lipca 2026 Początkujący
Na tej stronie
  1. Wbuduj Groka w swoje aplikacje
  2. Wymagania wstępne
  3. Konfiguracja początkowa
  4. Twoje pierwsze żądanie
  5. Co udostępnia API
  6. Wybór modelu
  7. Limity速率 i najlepsze praktyki
  8. Kluczowe wnioski

Wbuduj Groka w swoje aplikacje

Wszystko, czego nauczyłeś się robić w interfejsie Groka, możesz uruchomić z poziomu własnego kodu. API xAI przenosi te możliwości do Twoich aplikacji, stron internetowych i usług: rozmowa przestaje być miejscem, do którego się udajesz, a staje się funkcją wywoływaną przez Twój produkt.

Wymagania wstępne

Zanim napiszesz pierwszą linię kodu, potrzebujesz czterech rzeczy:

  1. Konto xAI założone na accounts.x.ai
  2. Klucz API wygenerowany w console.x.ai
  3. Skonfigurowana metoda płatności (aby przekroczyć darmowy limit)
  4. Środowisko programistyczne Python lub JavaScript

Pierwsze dwa punkty masz już za sobą w ramach tego kursu: konto obsługuje uwierzytelnianie, a klucz identyfikuje Twoją aplikację wobec API. Metoda płatności jest potrzebna dopiero wtedy, gdy Twoje zużycie przekroczy darmowy limit, co zdarza się szybciej, niż myślisz, gdy tylko usługa działa ciągle. Jeśli chodzi o środowisko, Python i JavaScript mają najlepsze narzędzia, ale ponieważ API komunikuje się przez HTTP, wystarczy dowolny język potrafiący wysłać żądanie.

Konfiguracja początkowa

Pierwszym krokiem jest bezpieczne zapisanie klucza API w zmiennej środowiskowej:

export XAI_API_KEY="xai-your-key-here"

Nigdy nie wpisuj klucza na sztywno w kodzie źródłowym. Powód jest prozaiczny: klucz zapisany w pliku prędzej czy później trafi do repozytorium Git, a klucz wypchnięty do publicznego repozytorium zostanie wykorzystany w ciągu kilku minut przez boty skanujące commity, podczas gdy rachunek przyjdzie na Twoje nazwisko.

Kolejny krok to wybór SDK. Natywne SDK xAI dla Pythona instalujesz poleceniem pip install xai-sdk. Jeśli Twój kod już wywołuje OpenAI, biblioteka openai zadziała bez zmian dzięki kompatybilności formatów. W przypadku JavaScript dodajesz Vercel AI SDK poprzez npm install ai @ai-sdk/xai, co integruje się z aplikacjami React i Next.js.

Twoje pierwsze żądanie

Korzystając z natywnego SDK, utworzenie klienta i rozpoczęcie rozmowy zajmuje trzy linijki:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")

Ścieżka kompatybilna z OpenAI jest równie bezpośrednia: zmienia się tylko base_url w porównaniu z istniejącym kodem, dlatego wiele zespołów przestawia się w kilka minut.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.5",
    input="Wyjaśnij mi uczenie maszynowe w 3 zdaniach."
)

Aby sprawdzić, czy klucz działa, zanim jeszcze napiszesz jakikolwiek kod, nic nie przebije wywołania z wiersza poleceń:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Cześć, jak się masz?"
  }'

Co udostępnia API

Fundamentem jest generowanie tekstu (odpowiedzi konwersacyjne, pisanie, analiza), wraz z trybem rozumowania, który krok po kroku rozwiązuje złożone problemy. Do tego dochodzi strumieniowanie, które dostarcza odpowiedź token po tokenie, zamiast kazać czekać na zakończenie generowania.

Drugi zestaw daje dostęp do informacji: wyszukiwanie w czasie rzeczywistym w sieci i na platformie X oraz RAG, które odpytuje stworzone przez Ciebie kolekcje dokumentów. Aspekt wielomodalny obejmuje rozumienie dostarczanych obrazów, generowanie obrazów i wideo za pomocą grok-imagine oraz obsługę głosu, obejmującą rozmowy głosowe i syntezę mowy (TTS).

Na koniec trzy mechanizmy sprawiają, że API jest programowalne w ścisłym sensie: wywoływanie funkcji, które pozwala modelowi uruchamiać Twoje własne funkcje; strukturyzowane wyjścia, gwarantujące użyteczny JSON bez kruchej postprocesingu; oraz wykonywanie kodu po stronie serwera.

Wybór modelu

Możliwości rozumowania różnią się w zależności od modelu. grok-4.7, flagowa jednostka, oferuje konfigurowalne rozumowanie: parametr reasoning_effort (low, medium, high lub xhigh) ustawia głębokość myślenia dla każdego żądania z osobna. grok-4.3 pozostaje opcją budżetową z bardzo długim kontekstem, kosztującą około połowy ceny. Istnieją też wersje modeli bez rozumowania do prostych zadań: parafrazowanie czy klasyfikacja nie wymagają wewnętrznych deliberacji.

Konwencje nazewnictwa wpływają na stabilność Twojej aplikacji:

  • grok-4.20: najnowsza zalecana wersja stabilna
  • grok-4.20-latest: najbardziej aktualna wersja (może się zmieniać)
  • grok-4.20-0309: wersja przypięta do konkretnej daty (9 marca)

W środowisku produkcyjnym przypięta wersja chroni Twoje prompty przed niezauważalnymi zmianami w modelu; latest nadaje się do eksploracji, pod warunkiem że akceptujesz możliwość zmiany zachowania.

Limity速率 i najlepsze praktyki

API egzekwuje limity速率, aby utrzymać stabilność usługi: w warstwie wejściowej jest to około 10 milionów tokenów na minutę i 1800 żądań na minutę dla modeli takich jak grok-4.3, a liczby te rosną wraz z wyższym poziomem usługi. Modele generujące obrazy i wideo mają własne, znacznie niższe limity, od 30 do 300 żądań na minutę w zależności od modelu, więc warto mieć je na oku w przypadku usług skierowanych do konsumentów.

Kilka nawyków odróżnia prototyp od solidnej integracji. Włącz strumieniowanie dla długich odpowiedzi, ponieważ trzydzieści sekund wpatrywania się w pusty ekran wygląda jak awaria. Przekaż ID rozmowy, aby skorzystać z cache’owania. Kieruj każde zadanie do odpowiedniego modelu: grok-4.3 do prostych zadań o dużej objętości, grok-4.20 do rozumowania. Obsługuj błędy poprzez ponawianie prób i wykładnicze opóźnienia (exponential backoff), inaczej skok ruchu zamieni się w lawinę odrzuconych żądań. I monitoruj swoje zużycie w konsoli, zanim pod koniec miesiąca zobaczysz całkowity rachunek.

Kluczowe wnioski

  • API xAI jest kompatybilne z formatem OpenAI, co ułatwia migrację
  • Dostępnych jest kilka SDK: natywne xAI, OpenAI oraz Vercel AI SDK
  • API obsługuje tekst, obrazy, wideo, głos i wyszukiwanie
  • Dwa poziomy modeli: grok-4.7 (flagowy, konfigurowalne rozumowanie) i grok-4.3 (budżetowy, kontekst 1M)
  • Zawsze przechowuj klucz API w zmiennej środowiskowej, nigdy nie wpisuj go na sztywno w kodzie