API xAI i kompatybilność z OpenAI
Na tej stronie
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:
- Bazowy adres URL: zamień
https://api.openai.com/v1nahttps://api.x.ai/v1 - 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
- Przejdź do console.x.ai
- Zaloguj się na swoje konto xAI (lub utwórz je na accounts.x.ai)
- W sekcji Klucze API (API Keys) wygeneruj nowy klucz
- 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/completionszstream: true: strumieniowanie zreasoning_content/v1/chat/completionsztools: 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_contentjest specyficzne dla API xAI i nie istnieje w API OpenAI
Kluczowe wnioski
- API xAI znajduje się pod adresem
https://api.x.ai/v1i 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