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

OpenAI SDK pro Grok

Lekce 6 z 14 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Využij své znalosti OpenAI
  2. Instalace
  3. Konfigurace klienta pro xAI
  4. Odeslání zprávy
  5. Migrace existujícího projektu OpenAI
  6. Rozdíly, které musíš znát
  7. Kdy tento přístup zvolit
  8. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě stránky Models od xAI: model grok-4.7 (září 2026) nahradil grok-4.5 jako doporučený model; příklad napsaný pro grok-4.5 funguje také s grok-4.7. Zdroje: Models · Release notes.

Upřesněno 3. listopadu 2026 na základě reference xAI Chat Completions: volání není zcela totožné s OpenAI; parametry logprobs a top_logprobs (od verze grok-4.20 ignorovány) a logit_bias (nepodporován) rozšiřují níže uvedené rozdíly. Zdroj: xAI, Chat Completions.

Využij své znalosti OpenAI

Pokud již pracuješ s OpenAI SDK v Pythonu, můžeš jej použít tak, jak je, pro volání Grok API. Stačí přesměrovat požadavky na servery xAI změnou základní URL. Je to nejrychlejší přístup, pokud máš existující kód.

Instalace

Pokud ještě nemáš v projektu nainstalované OpenAI SDK:

pip install openai

Konfigurace klienta pro xAI

Jediný rozdíl oproti běžnému použití OpenAI spočívá v parametru base_url:

from openai import OpenAI
import os

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

To je vše. Od této chvíle fungují všechny metody OpenAI SDK s modely Grok.

Odeslání zprávy

Volání má stejnou strukturu jako u GPT, kromě nepodporovaných parametrů (viz níže):

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "system", "content": "You are a technical assistant."},
        {"role": "user", "content": "What's the difference between REST and GraphQL?"}
    ],
    temperature=0.7,
    max_completion_tokens=500
)

print(response.choices[0].message.content)

Dostupné modely

Stačí nahradit název modelu OpenAI názvem modelu Grok:

  • grok-4.7: model doporučený společností xAI, všestranný, podporuje vstupní obrázky (modely grok-4.6 a grok-4.5 zůstávají k dispozici)
  • grok-4.20-0309-reasoning: pokročilé logické uvažování
  • grok-4.3: rychlé a levné odpovědi (kontext 1M)

Migrace existujícího projektu OpenAI

Pro úpravu stávajícího projektu máš dvě možnosti.

Možnost 1: Proměnné prostředí

Změň proměnné bez zásahu do kódu:

export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"

OpenAI SDK si tyto proměnné načte automaticky. Tvůj existující kód bude fungovat, pokud také změníš název modelu a odstraníš parametry, které xAI nepodporuje.

Možnost 2: Explicitní konfigurace

Napiš inicializační funkci, která přepíná mezi poskytovateli:

import os
from openai import OpenAI

def create_client(provider="xai"):
    if provider == "xai":
        return OpenAI(
            api_key=os.getenv("XAI_API_KEY"),
            base_url="https://api.x.ai/v1"
        )
    return OpenAI()  # Ve výchozím nastavení OpenAI

client = create_client("xai")

Tento přístup ti umožňuje snadno přepínat mezi poskytovateli během migrace.

Rozdíly, které musíš znát

Ačkoli je API kompatibilní, některé behaviorální aspekty se liší:

  • Parametry frequency_penalty a presence_penalty nejsou podporovány u modelů pro logické uvažování (reasoning)
  • Parametr stop není u modelů pro logické uvažování k dispozici
  • Parametry logprobs a top_logprobs jsou u modelů grok-4.20 a novějších tiše ignorovány a logit_bias není podporován
  • Názvy modelů jsou samozřejmě odlišné
  • Některé funkce xAI (vyhledávání na X, webové vyhledávání) nejsou prostřednictvím standardního formátu OpenAI dostupné

Kdy tento přístup zvolit

Režim kompatibility dává největší smysl, když je pro tebe důležitější existující kód než exkluzivní funkce. Nejčastějším případem je migrace: kód již napsaný pro OpenAI přejde na Grok změnou základní URL a klíče: dva řádky, žádný přepis. Důležitá je také reverzibilita: dokud zůstaneš u formátu OpenAI, zůstává přepínání poskytovatelů záležitostí konfigurace, což je cenné pro porovnávání modelů nebo vyjednávání. Pak je tu ekosystém: nástroje třetích stran postavené kolem OpenAI SDK, jako jsou LangChain a LlamaIndex, fungují okamžitě a tým, který již SDK zná, se nemusí učit nic nového. Cenou za to je výše zmíněné: funkce specifické pro xAI ustupují do pozadí.

Klíčové poznatky

  • Přidej base_url="https://api.x.ai/v1" do konstruktoru OpenAI()
  • Nahraď API klíč a název modelu
  • Proměnné OPENAI_BASE_URL a OPENAI_API_KEY umožňují migraci bez zásahu do kódu
  • Některé parametry (penalizace, stop) nejsou u modelů pro logické uvažování podporovány