Grok API: pierwsze zapytanie w dziesięć minut, krok po kroku

👁 112 przeczytań

Pierwsze zapytanie do API Groka to cztery kroki i mniej więcej dziesięć minut, z czego połowa idzie na założenie konta. Przeszedłem oficjalny przewodnik producenta krok po kroku i opisałem go po polsku razem z rzeczami, które w dokumentacji są rozrzucone po pięciu stronach, a przy pierwszym podejściu potrafią zatrzymać.

Krok 1. Konto i kredyty

Konto zakładasz w konsoli producenta pod adresem console.x.ai. Samo konto nie wystarczy - dokumentacja mówi wprost, że trzeba je zasilić kredytami, żeby zacząć korzystać z API. Rozliczenie jest za zużycie, bez kwoty minimalnej.

Warto od razu wiedzieć, ile to kosztuje, żeby dobrać pierwsze zasilenie: Grok 4.7 to 2 USD za milion tokenów wejścia i 6 USD za milion wyjścia. Kilka dolarów wystarcza na tygodnie eksperymentowania.

Krok 2. Klucz API

Klucz tworzysz na stronie kluczy w konsoli, a potem ustawiasz go jako zmienną środowiskową:

export XAI_API_KEY="twoj_klucz"

Albo dopisujesz do pliku .env w katalogu projektu:

XAI_API_KEY=twoj_klucz

Zasada, którą warto przyjąć od pierwszego dnia: klucz nigdy nie trafia do kodu ani do repozytorium. Zmienna środowiskowa albo plik .env dopisany do .gitignore - i tyle. Klucz wrzucony do publicznego repozytorium jest znajdowany przez automaty w ciągu minut, a rachunek za cudze zużycie idzie na Twoją kartę.

Krok 3. Biblioteka

Producent daje wybór w czterech wariantach: własna biblioteka dla Pythona i JavaScriptu oraz warianty zgodne z interfejsem OpenAI dla obu tych języków.

pip install xai-sdk

Kiedy wybrać który:

Ostatni wiersz nie jest oczywisty, więc go rozwinę: dokumentacja zaznacza, że nie wszystkie narzędzia działają w obu interfejsach. Przy interfejsie gRPC w bibliotece Pythona nie są obsługiwane narzędzia code_interpreter i file_search, choć w nowszym interfejsie odpowiedzi działają wszystkie. Jeśli planujesz uruchamianie kodu albo przeszukiwanie plików, sprawdź to zanim napiszesz pół aplikacji.

Krok 4. Pierwsze zapytanie

Przykład wprost z dokumentacji producenta, w Pythonie:

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("Napisz funkcję walidującą numer PESEL i dziesięć testów do niej"))
print(chat.sample().content)

To wszystko. Jeśli to zadziałało, masz działające połączenie i możesz przejść do rzeczy trudniejszych - rozmowy wielotorowej, odpowiedzi w ustalonej strukturze i strumieniowania.

Generowanie obrazu - też cztery linijki

import os, xai_sdk
client = xai_sdk.Client(api_key=os.getenv("XAI_API_KEY"))
response = client.image.sample(
    prompt="A futuristic city skyline at sunset",
    model="grok-imagine-image-2.0",
)
print(response.url)

Model obrazu to osobna nazwa i osobny cennik - od 0,04 USD za sztukę w wariancie 1K. Praktyczne wskazówki do samych promptów zebrałem w tekście o generowaniu grafiki.

Pięć rzeczy, które zaskakują przy pierwszym podejściu

1. Model nie zna bieżących wydarzeń. Dokumentacja mówi to wprost: bez włączonych narzędzi wyszukiwania model nie ma wiedzy poza danymi treningowymi. Data odcięcia wiedzy Groka 4.7 to maj 2026. Jeśli pytasz o coś świeższego, musisz włączyć wyszukiwanie w sieci albo na X.
2. Nazwy modeli mają aliasy. Sama nazwa wskazuje najnowszą stabilną wersję, wariant z przyrostkiem oznaczającym najnowszą - po prostu najnowszą, a nazwa z datą - konkretne wydanie, które się nie zmieni. Do produkcji, w której liczy się powtarzalność, bierz wersję z datą.
3. Kolejność ról jest dowolna. Nie ma wymogu, żeby wiadomość systemowa szła pierwsza - role można mieszać w dowolnej kolejności.
4. Pola logprobs nie działają w modelach 4.20 i nowszych. Nie zgłaszają błędu - są po cichu ignorowane. To najgorszy rodzaj niezgodności, bo kod działa, a wynik jest inny, niż zakładasz.
5. Obrazy na wejściu mają limity: maksymalnie 20 MiB na plik, wyłącznie jpg i png. Liczba obrazów w zapytaniu nie jest ograniczona, a kolejność tekstu i obrazu dowolna.

Co możesz włączyć dalej

Po pierwszym zapytaniu warto wiedzieć, co jeszcze jest w platformie, bo to ona, a nie sam model, decyduje o tym, ile zbudujesz:

Do tego dochodzą tokeny zużyte przez samo narzędzie. Pełne rozliczenie narzędzi serwerowych rozbieram w osobnym tekście, bo to tam robi się najwięcej niespodzianek na rachunku.

Najczęstsze pytania

Jak zacząć korzystać z API Groka?

Załóż konto w konsoli producenta, zasil je kredytami, wygeneruj klucz, ustaw go jako zmienną środowiskową i zainstaluj bibliotekę. Pierwsze zapytanie to cztery linijki kodu.

Czy API Groka jest zgodne z OpenAI?

Tak, producent udostępnia warianty zgodne z tym interfejsem dla Pythona i JavaScriptu. Istniejącego kodu nie trzeba przepisywać.

Jak nazywa się model w API?

grok-4.7. Do obrazów grok-imagine-image-2.0, do wideo grok-imagine-video-1.5.

Czy jest darmowy poziom API?

Dokumentacja mówi o zasileniu konta kredytami przed rozpoczęciem pracy. Rozliczenie jest za zużycie, bez kwoty minimalnej.

Dlaczego model nie zna dzisiejszych wiadomości?

Bo bez włączonych narzędzi wyszukiwania działa wyłącznie na danych treningowych, a te kończą się w maju 2026. Włącz wyszukiwanie w sieci lub na X.

Którą nazwę modelu wybrać do produkcji?

Wersję z datą wydania. Aliasy aktualizują się same do nowszych wersji, co w produkcji potrafi zmienić zachowanie bez Twojej wiedzy.