SDK OpenAI z base_url xAI
Na tej stronie
Zaktualizowano 3 listopada 2026 r. Zgodnie z dokumentacją referencyjną Chat Completions od xAI, kompatybilność z SDK OpenAI nie jest „w 100%“ – kilka parametrów nie jest obsługiwanych przez modele rozumujące, jest ignorowanych przez najnowsze modele lub nie jest obsługiwanych przez żaden model. Źródło: xAI, Chat Completions.
Używanie SDK OpenAI do dostępu do Grok
Jedną z głównych zalet punktu końcowego Chat Completions od xAI jest jego kompatybilność z SDK OpenAI. Możesz użyć pakietu openai, który już znasz, zmieniając jedynie base_url, aby wskazywał na serwery xAI.
Podejście to jest idealne, jeśli migrujesz istniejącą aplikację z OpenAI do Grok lub jeśli chcesz przełączać się między dostawcami przy minimalnych zmianach.
Konfiguracja
Instalacja wygląda tak samo jak w przypadku każdego projektu korzystającego z SDK OpenAI:
pip install openai
Jedyną różnicą jest tworzenie klienta, gdzie określasz adres URL podstawowy i klucz API xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Dwa kluczowe parametry to:
api_key: Twój klucz API xAI (nie klucz OpenAI)base_url:https://api.x.ai/v1– przekierowuje żądania do xAI zamiast do OpenAI
Wywołania identyczne jak w OpenAI
Po skonfigurowaniu klienta sposób użycia jest taki sam jak w standardowym SDK OpenAI – z wyjątkiem parametrów nieobsługiwanych przez xAI, które szczegółowo opisano poniżej:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What is the difference between TCP and UDP?"}
],
temperature=0.7,
max_tokens=1000
)
print(response.choices[0].message.content)
Jedyną widoczną różnicą jest nazwa modelu: grok-4.20-0309-reasoning zamiast np. gpt-5.6.
Strumieniowanie z SDK OpenAI
Strumieniowanie działa dokładnie tak samo:
stream = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "user", "content": "Explain the concept of microservices."}
],
stream=True
)
for chunk in stream:
content = chunk.choices[0].delta.content
if content:
print(content, end="", flush=True)
JavaScript / TypeScript
SDK OpenAI dla Node.js działa w ten sam sposób:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: "https://api.x.ai/v1",
});
const response = await client.chat.completions.create({
model: "grok-4.20-0309-reasoning",
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "Hello, how are you?" },
],
});
console.log(response.choices[0].message.content);
Zwróć uwagę, że w JavaScript właściwość to baseURL (wielkie U), podczas gdy w Pythonie jest to base_url.
Przełączanie się między dostawcami
Główną zaletą tego podejścia jest możliwość zmiany dostawcy poprzez modyfikację jednej zmiennej:
import os
from openai import OpenAI
provider = os.getenv("LLM_PROVIDER", "xai")
configs = {
"xai": {
"api_key": os.getenv("XAI_API_KEY"),
"base_url": "https://api.x.ai/v1",
"model": "grok-4.20-0309-reasoning"
},
"openai": {
"api_key": os.getenv("OPENAI_API_KEY"),
"base_url": "https://api.openai.com/v1",
"model": "gpt-5.6"
}
}
config = configs[provider]
client = OpenAI(api_key=config["api_key"], base_url=config["base_url"])
Taka architektura wielodostawcza jest powszechna w aplikacjach produkcyjnych, które chcą zachować elastyczność.
Co nie przenosi się między dostawcami
Kompatybilność nie oznacza tożsamości. Dokumentacja referencyjna punktu końcowego xAI wskazuje kilka parametrów, których nie obsługują modele rozumujące: frequency_penalty, presence_penalty (podobnie jak w grok-3) oraz stop. Parametry logprobs i top_logprobs są ignorowane bez błędu przez modele grok-4.20 i nowsze, a logit_bias nie jest obsługiwany. Kod ustawiający te parametry dla OpenAI będzie wymagał ich usunięcia dla Grok. Pola cicho ignorowane są najbardziej podstępne, ponieważ nic nie sygnalizuje, że nie mają one żadnego efektu. Narzędzia hostowane również różnią się między dostawcami: wyszukiwarka internetowa OpenAI to nie to samo co narzędzie xAI. Co więcej, xAI obecnie klasyfikuje Chat Completions jako punkt końcowy przestarzały i zaleca korzystanie z API Responses (lekcje 11 i 12).
Kluczowe wnioski
- SDK OpenAI działa z xAI po prostu poprzez zmianę
base_urlnahttps://api.x.ai/v1 - Metody i formaty odpowiedzi są takie same, ale niektóre parametry nie są obsługiwane (
frequency_penalty,presence_penalty,stopw modelach rozumujących,logit_bias) lub są ignorowane (logprobsod wersjigrok-4.20wzwyż) - Dostosuj klucz API, nazwę modelu oraz usuń nieobsługiwane parametry
- Podejście to upraszcza migrację z OpenAI i umożliwia przełączanie się między dostawcami
- Strumieniowanie i typowanie SDK OpenAI działają poprawnie; narzędzia hostowane są specyficzne dla każdego dostawcy