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

API xAI a kompatibilita s OpenAI

Lekce 4 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Známé rozhraní API
  2. Minimální konfigurace
  3. Získání klíče API
  4. Dostupné koncové body
  5. Omezení kompatibility
  6. Klíčové poznatky

Známé rozhraní API

API xAI používá stejný formát jako API OpenAI. Pokud jsi již dříve pracoval s API OpenAI nebo kompatibilními nástroji, nemusíš se učit nic nového. Jediné, co se mění, je základní URL.

https://api.x.ai/v1

Tato kompatibilita je strategickou volbou společnosti xAI. Místo zavádění nového proprietárního formátu přijali de facto průmyslový standard. Výsledkem je, že jakýkoli nástroj, SDK nebo editor podporující API OpenAI může okamžitě využít grok-build-0.1.

Minimální konfigurace

Pro přepnutí z OpenAI na xAI v jakémkoli kompatibilním klientovi musíš změnit pouze dva parametry:

  1. Základní URL: nahraď https://api.openai.com/v1 za https://api.x.ai/v1
  2. Klíč API: použij svůj klíč API xAI (získaný z console.x.ai)

Všechno ostatní – formát zpráv, parametry teploty, struktura odpovědi – je totožné.

Příklad s Python SDK pro 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."}
    ]
)

Standardní SDK OpenAI používáš bez jakýchkoli úprav. Mění se pouze base_url a název modelu.

Příklad s 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"}
    ]
  }'

Získání klíče API

  1. Přejdi na console.x.ai
  2. Přihlas se svým účtem xAI (nebo si vytvoř nový na accounts.x.ai)
  3. V sekci API Keys vygeneruj nový klíč
  4. Okamžitě si jej zkopíruj – znovu se již nezobrazí

Tento klíč uchovávej v bezpečí. Nikdy jej neodesílej do Git repozitáře ani nesdílej v týmovém chatu. Použij proměnnou prostředí nebo správce tajných údajů.

Dostupné koncové body

grok-build-0.1 podporuje následující koncové body, všechny ve formátu OpenAI:

  • /v1/chat/completions: generování textu a kódu (nejpoužívanější)
  • /v1/chat/completions s stream: true: streamování s reasoning_content
  • /v1/chat/completions s tools: nativní volání nástrojů

Omezení kompatibility

Existuje několik drobných rozdílů:

  • Dostupné modely jsou od xAI (grok-build-0.1, grok-4.5 atd.), nikoli od OpenAI
  • Některé parametry specifické pro OpenAI (jako logprobs) nemusí být podporovány
  • reasoning_content je specifické pro API xAI a v API OpenAI neexistuje

Klíčové poznatky

  • API xAI běží na https://api.x.ai/v1 a je kompatibilní s formátem OpenAI
  • Pro migraci stačí změnit základní URL a klíč API
  • Python SDK pro OpenAI funguje tak, jak je
  • Klíč API získáš na console.x.ai
  • Všechny editory kompatibilní s OpenAI fungují s xAI