Grok API: wywoływanie Grok we własnym kodzie

Dwa sposoby na korzystanie z Grok w kodzie

Deweloperzy mogą wywoływać modele Grok głównie na dwa sposoby. Pierwszy to API xAI, obsługiwane bezpośrednio przez firmę (obecnie pod marką SpaceXSI), z kluczami z console.x.ai. Drugi to router modeli, taki jak OpenRouter, który udostępnia modele wielu dostawców w ramach jednego klucza i wspólnego rachunku. Obie opcje obsługują żądania w formacie OpenAI Chat Completions, więc oficjalne biblioteki SDK OpenAI działają od razu — wystarczy zmienić adres bazowy i nazwę modelu.

Którą ścieżkę wybrać

• API xAI, jeśli chcesz mieć dostęp do wszystkich nowości Grok w pierwszej kolejności: pełnej listy modeli, Responses API, narzędzi wyszukiwania w sieci i na platformie X po stronie serwera, generowania obrazów i wideo z Grok Imagine, głosu, zadań wsadowych (batch) oraz zniżek na cache'owane prompty. Bazowy adres URL: https://api.x.ai/v1.
• OpenRouter, jeśli chcesz swobodnie przełączać się między Grok a modelami innych firm bez podpisywania nowych umów lub masz już konto na platformie OpenRouter. Bazowy adres URL: https://openrouter.ai/api/v1, identyfikatory modeli z prefiksem x-ai/. Instrukcję konfiguracji znajdziesz w przewodniku OpenRouter.

Niezależnie od wyboru, trzymaj klucz na serwerze lub w zmiennej środowiskowej. Nigdy nie umieszczaj go w kodzie strony internetowej ani aplikacji mobilnej, gdzie każdy może go podejrzeć.

Twoje pierwsze żądanie do API xAI

Wygeneruj klucz w konsoli, zapisz go jako XAI_API_KEY i wyślij wiadomość do Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "Jesteś zwięzłym asystentem."},
      {"role": "user", "content": "Podaj trzy wskazówki przed pierwszym maratonem."}
    ]
  }'

Python (z biblioteką OpenAI)

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Czy 391 to liczba pierwsza? Pokaż obliczenia."}],
)
print(answer.choices[0].message.content)

Parametr reasoning_effort określa, jak długo model zastanawia się przed udzieleniem odpowiedzi. Grok 4.3 obsługuje wartości: none, low, medium, high oraz xhigh (domyślnie: low); Grok 4.7 akceptuje low, medium, high i xhigh (domyślnie: high). Dla Grok 4.20 xAI udostępnia osobne identyfikatory: grok-4.20-0309-reasoning oraz grok-4.20-0309-non-reasoning.

To samo przez OpenRouter

W OpenRouter zapisz klucz w zmiennej OPENROUTER_API_KEY i używaj identyfikatorów z prefiksem x-ai/. Proces myślenia konfiguruje się tu za pomocą obiektu reasoning. Poniższy kod JavaScript działa w Node.js 18 lub nowszym:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Przepisz ten nagłówek w spokojniejszym tonie: CENY ZNOWU OSZALAŁY" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Aby model wykorzystał rozumowanie, przekaż reasoning: { effort: "low" } (lub medium, high). Dodaj exclude: true, jeśli chcesz, aby proces myślenia wpłynął na odpowiedź, ale nie był zwracany w wyniku. Ustaw stream: true, aby odbierać tekst na bieżąco w trakcie generowania — w interfejsie czatu daje to wrażenie znacznie szybszego działania.

Wysyłanie obrazu

Grok 4.20, 4.3 i 4.7 potrafią analizować obrazy. Użyj formatu wiadomości znanego z OpenAI z listą elementów zawartości. Dokumentacja xAI akceptuje pliki JPEG i PNG o rozmiarze do 20 MiB; możesz podać publiczny URL lub zakodować obraz w base64.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "Wypisz pozycje i łączną kwotę z tego paragonu."}
    ]
  }]
}

Identyfikatory modeli Grok i ceny

Oto aktualne modele tekstowe SpaceXAI dostępne na platformie OpenRouter, wraz z oknem kontekstu i cenami za milion tokenów (cennik OpenRouter, październik 2026). W API xAI obowiązują te same stawki bazowe dla promptów poniżej 200 000 tokenów.

Warto pamiętać o kilku szczegółach z cennika xAI (październik 2026):

• Długie prompty kosztują więcej. Gdy prompt osiągnie 200 000 tokenów, całe żądanie rozliczane jest według wyższej stawki: $4 / $12 dla Grok 4.7 oraz $2.50 / $5 dla Grok 4.3 i 4.20.
• Cache'owane dane wejściowe są tańsze: $0.50 za milion tokenów w przypadku Grok 4.7 oraz $0.20 dla Grok 4.3 i 4.20 (przy powtarzających się prefiksach promptu).
• Zadania wsadowe (batch) realizowane z opóźnieniem są objęte zniżką; OpenRouter oferuje model x-ai/grok-4.3:batch w cenie $1 / $2.
• Wielkość kontekstu zależy od źródła: OpenRouter podaje 2 000 000 tokenów dla Grok 4.20, podczas gdy oficjalna dokumentacja xAI wskazuje 1 000 000.

Tokeny zużyte na myślenie (reasoning) wliczają się do tokenów wyjściowych, dlatego modele rozumujące mogą generować wyższy koszt pojedynczej odpowiedzi, niż sugerowałaby bazowa cena.

Praktyczne wskazówki

• Zacznij od Grok 4.20 non-reasoning do czatu, redagowania tekstu i ekstrakcji danych. Działa szybko i jest niedrogi. Sięgnij po Grok 4.3 lub 4.7, gdy jakość w skomplikowanych zadaniach jest ważniejsza niż czas odpowiedzi.
• Pamiętaj o dacie wiedzy (cut-off). Według xAI model Grok 4.7 posiada wiedzę do maja 2026 r. Jeśli potrzebujesz nowszych informacji, przekaż je w prompcie lub skorzystaj z serwerowych narzędzi xAI do przeszukiwania sieci i platformy X (rozliczanych za każde wywołanie).
• Twórz jasne instrukcje systemowe, określając rolę, ton i format wyjściowy. Gdy parsujesz odpowiedź w kodzie, poproś o format JSON ze schematem.
• Obsługuj limity zapytań (rate limits). W razie otrzymania błędu 429 ponów próbę po krótkiej pauzie.
• Przestrzegaj zasad. Korzystanie z API podlega zasadom dopuszczalnego użytkowania xAI, a pole safety_identifier pozwala oznaczać żądania przypisane do konkretnych użytkowników końcowych.

Gdy coś pójdzie nie tak

• 401 lub 403: brak klucza, klucz unieważniony lub załadowany w niewłaściwym środowisku. Wyświetl jego pierwsze znaki na serwerze, aby upewnić się, że zmienna jest ustawiona.
• Model not found: sprawdź prefiks. OpenRouter wymaga formatu x-ai/grok-4.7, a xAI przyjmuje samą nazwę grok-4.7.
• Pusta lub bardzo wolna odpowiedź z modelu rozumującego oznacza zazwyczaj, że limit tokenów wyjściowych został wyczerpany na etap myślenia. Zmniejsz poziom effort lub zwiększ max_tokens.
• Odrzucony obraz: przekonwertuj plik do formatu JPEG lub PNG i upewnij się, że mieści się w limicie rozmiaru.

Często zadawane pytania (FAQ)

Czy API Grok jest kompatybilne z biblioteką OpenAI SDK?

Tak. Skieruj SDK na adres https://api.x.ai/v1 z kluczem xAI lub na OpenRouter z kluczem OpenRouter i podaj odpowiedni identyfikator modelu Grok.

Czy istnieje darmowe API Grok?

Nie ma stałego, darmowego planu. Zarówno xAI, jak i OpenRouter rozliczają się za tokeny, choć krótkie testy kosztują ułamki centa.

Czy przez API Grok można generować obrazy?

Tak, za pośrednictwem modeli Grok Imagine od xAI na osobnym endpoincie do obsługi obrazów. Szczegóły znajdziesz na naszej stronie Grok Imagine. Nasz czat nie generuje obrazów.

Z którego modelu Grok korzysta Grok.Online?

Nasz czat oferuje model Grok 4.20 z wyłączonym rozumowaniem, Grok 4.3 z niskim poziomem rozumowania (low effort) oraz Grok 4.7 z limitem do 10 wiadomości dziennie — wszystkie za pośrednictwem OpenRouter.