Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

OpenAI SDK s base_url od xAI

Lekce 5 z 12 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Použití OpenAI SDK pro přístup ke Grok
  2. Konfigurace
  3. Volání totožná s OpenAI
  4. Streamování s OpenAI SDK
  5. JavaScript / TypeScript
  6. Přepínání mezi poskytovateli
  7. Co se mezi poskytovateli nepřenáší
  8. Klíčové poznatky

Aktualizováno 3. listopadu 2026. Podle reference k Chat Completions od xAI není kompatibilita s OpenAI SDK „100%“ – několik parametrů není podporováno modely pro uvažování (reasoning models), jsou ignorovány nejnovějšími modely nebo nejsou podporovány žádným modelem. Zdroj: xAI, Chat Completions.

Použití OpenAI SDK pro přístup ke Grok

Jednou z hlavních výhod koncového bodu Chat Completions od xAI je jeho kompatibilita s OpenAI SDK. Můžeš použít balíček openai, který již znáš, a pouze změnit base_url tak, aby směřoval na servery xAI.

Tento přístup je ideální, pokud migruješ existující aplikaci z OpenAI na Grok, nebo pokud chceš přepínat mezi poskytovateli s minimálními změnami.

Konfigurace

Instalace je stejná jako u jakéhokoli projektu využívajícího OpenAI SDK:

pip install openai

Jediný rozdíl spočívá ve vytvoření klienta, kde zadáš základní URL a API klíč xAI:

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

Dva zásadní parametry jsou:

  • api_key: Tvůj API klíč xAI (nikoli klíč od OpenAI)
  • base_url: https://api.x.ai/v1 – toto přesměruje požadavky na xAI místo na OpenAI

Volání totožná s OpenAI

Jakmile je klient nakonfigurován, používá se stejně jako standardní OpenAI SDK – s výjimkou parametrů, které xAI nepodporuje a které jsou podrobně popsány níže:

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)

Jediný viditelný rozdíl je název modelu: grok-4.20-0309-reasoning místo například gpt-5.6.

Streamování s OpenAI SDK

Streamování funguje naprosto stejně:

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

OpenAI SDK pro Node.js funguje stejným způsobem:

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);

Všimni si, že vlastnost se v JavaScriptu jmenuje baseURL (velké U), zatímco v Pythonu je to base_url.

Přepínání mezi poskytovateli

Hlavní výhodou tohoto přístupu je možnost změnit poskytovatele pomocí jediné proměnné:

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"])

Tato architektura s více poskytovateli je běžná v produkčních aplikacích, které chtějí zachovat flexibilitu.

Co se mezi poskytovateli nepřenáší

Kompatibilní neznamená totožné. Reference koncového bodu xAI upozorňuje na několik parametrů, které modely pro uvažování nepodporují – frequency_penalty, presence_penalty (jako u grok-3) a stop. Parametry logprobs a top_logprobs jsou modely grok-4.20 a novějšími ignorovány bez chyby a logit_bias není podporován vůbec. Kód, který tyto parametry nastavuje pro OpenAI, bude nutné pro Grok odstranit. Pole, která jsou tiše ignorována, jsou nejzrádnější, protože nic nenaznačuje, že nemají žádný efekt. Hostované nástroje se také mezi poskytovateli liší: webové vyhledávání od OpenAI není totéž co u xAI. Nakonec, xAI nyní klasifikuje Chat Completions jako zastaralý koncový bod a doporučuje API Responses (lekce 11 a 12).

Klíčové poznatky

  • OpenAI SDK funguje s xAI pouhou změnou base_url na https://api.x.ai/v1
  • Metody a formáty odpovědí jsou stejné, ale některé parametry nejsou podporovány (frequency_penalty, presence_penalty, stop u modelů pro uvažování, logit_bias) nebo jsou ignorovány (logprobs od verze grok-4.20 výše)
  • Přizpůsob API klíč, název modelu a nepodporované parametry
  • Tento přístup zjednodušuje migraci z OpenAI a umožňuje přepínání mezi poskytovateli
  • Streamování a typování OpenAI SDK fungují; hostované nástroje jsou specifické pro každého poskytovatele