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

SDK OpenAI z base_url xAI

Lekcja 5 z 12 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Używanie SDK OpenAI do dostępu do Grok
  2. Konfiguracja
  3. Wywołania identyczne jak w OpenAI
  4. Strumieniowanie z SDK OpenAI
  5. JavaScript / TypeScript
  6. Przełączanie się między dostawcami
  7. Co nie przenosi się między dostawcami
  8. Kluczowe wnioski

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_url na https://api.x.ai/v1
  • Metody i formaty odpowiedzi są takie same, ale niektóre parametry nie są obsługiwane (frequency_penalty, presence_penalty, stop w modelach rozumujących, logit_bias) lub są ignorowane (logprobs od wersji grok-4.20 wzwyż)
  • 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