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

API xAI i kompatybilność z OpenAI

Lekcja 4 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Znajome API
  2. Minimalna konfiguracja
  3. Uzyskanie klucza API
  4. Dostępne punkty końcowe
  5. Ograniczenia kompatybilności
  6. Kluczowe wnioski

Znajome API

API xAI korzysta z tego samego formatu co API OpenAI. Jeśli wcześniej pracowałeś z API OpenAI lub kompatybilnymi narzędziami, nie musisz uczyć się niczego nowego. Jedyną rzeczą, która ulega zmianie, jest bazowy adres URL.

https://api.x.ai/v1

Ta kompatybilność jest strategicznym wyborem firmy xAI. Zamiast narzucać nowy, zastrzeżony format, przyjęto de facto standard branżowy. W rezultacie każde narzędzie, SDK lub edytor obsługujące API OpenAI mogą natychmiast korzystać z modelu grok-build-0.1.

Minimalna konfiguracja

Aby przejść z OpenAI do xAI w dowolnym kompatybilnym kliencie, musisz zmienić tylko dwa parametry:

  1. Bazowy adres URL: zamień https://api.openai.com/v1 na https://api.x.ai/v1
  2. Klucz API: użyj swojego klucza API xAI (uzyskanego z console.x.ai)

Wszystko inne – format wiadomości, parametry temperatury, struktura odpowiedzi – pozostaje identyczne.

Przykład z Python SDK od OpenAI

from openai import OpenAI

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

response = client.chat.completions.create(
    model="grok-build-0.1",
    messages=[
        {"role": "system", "content": "You are a programming assistant."},
        {"role": "user", "content": "Write a quicksort function in Python."}
    ]
)

Używasz standardowego SDK OpenAI bez żadnych modyfikacji. Zmieniają się tylko base_url oraz nazwa modelu.

Przykład z curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer your-xai-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-build-0.1",
    "messages": [
      {"role": "user", "content": "Explain the difference between let and const in JavaScript"}
    ]
  }'

Uzyskanie klucza API

  1. Przejdź do console.x.ai
  2. Zaloguj się na swoje konto xAI (lub utwórz je na accounts.x.ai)
  3. W sekcji Klucze API (API Keys) wygeneruj nowy klucz
  4. Skopiuj go natychmiast – nie zostanie wyświetlony ponownie

Przechowuj ten klucz bezpiecznie. Nigdy nie commituj go do repozytorium Git ani nie udostępniaj na czacie zespołowym. Użyj zmiennej środowiskowej lub menedżera sekretów.

Dostępne punkty końcowe

grok-build-0.1 obsługuje następujące punkty końcowe, wszystkie w formacie OpenAI:

  • /v1/chat/completions: generowanie tekstu i kodu (najczęściej używane)
  • /v1/chat/completions z stream: true: strumieniowanie z reasoning_content
  • /v1/chat/completions z tools: natywne wywoływanie narzędzi

Ograniczenia kompatybilności

Istnieje kilka drobnych różnic:

  • Dostępne modele to modele xAI (grok-build-0.1, grok-4.5 itp.), a nie OpenAI
  • Niektóre parametry specyficzne dla OpenAI (takie jak logprobs) mogą nie być obsługiwane
  • reasoning_content jest specyficzne dla API xAI i nie istnieje w API OpenAI

Kluczowe wnioski

  • API xAI znajduje się pod adresem https://api.x.ai/v1 i jest kompatybilne z formatem OpenAI
  • Aby przeprowadzić migrację, wystarczy zmienić bazowy adres URL i klucz API
  • Python SDK od OpenAI działa bez zmian
  • Klucz API uzyskasz na console.x.ai
  • Wszystkie edytory kompatybilne z OpenAI działają z xAI