Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

xAI API és OpenAI-kompatibilitás

4. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Egy ismerős API
  2. Minimális konfiguráció
  3. API kulcs igénylése
  4. Elérhető végpontok
  5. Kompatibilitási korlátok
  6. Főbb megállapítások

Egy ismerős API

Az xAI API ugyanazt a formátumot használja, mint az OpenAI API. Ha korábban dolgoztál már az OpenAI API-val vagy kompatibilis eszközökkel, semmi újat nem kell tanulnod. Csak a base URL változik.

https://api.x.ai/v1

Ez a kompatibilitás az xAI stratégiai döntése. Ahelyett, hogy egy új, saját formátumot kényszerítettek volna ki, a de facto ipari szabványt fogadták el. Ennek eredményeként bármely eszköz, SDK vagy szerkesztő, amely támogatja az OpenAI API-t, azonnal képes használni a grok-build-0.1 modellt.

Minimális konfiguráció

Ahhoz, hogy bármely kompatibilis kliensben az OpenAI-ról az xAI-ra válts, csupán két paramétert kell módosítanod:

  1. Base URL: cseréld le a https://api.openai.com/v1 címet erre: https://api.x.ai/v1
  2. API kulcs: használd az xAI API kulcsodat (a console.x.ai oldalról szerezheted be)

Minden más – az üzenetformátum, a hőmérséklet-paraméterek, a válasz struktúrája – teljesen azonos marad.

Példa az OpenAI Python SDK-val

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

A szabványos OpenAI SDK-t módosítás nélkül használhatod. Csak a base_url és a modellnév változik.

Példa curllel

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"}
    ]
  }'

API kulcs igénylése

  1. Nyisd meg a console.x.ai oldalt
  2. Jelentkezz be az xAI-fiókodba (vagy hozz létre egyet az accounts.x.ai oldalon)
  3. Az API Keys szekcióban generálj egy új kulcsot
  4. Azonnal másold ki – többé nem fog megjelenni

Őrizd meg ezt a kulcsot biztonságos helyen. Soha ne commitold Git-tárolóba, és ne oszd meg csapatcsevegésben. Használj környezeti változót vagy titokkezelőt.

Elérhető végpontok

A grok-build-0.1 a következő végpontokat támogatja, mindegyiket OpenAI-formátumban:

  • /v1/chat/completions: szöveg- és kódgenerálás (a leggyakrabban használt)
  • /v1/chat/completions a stream: true paraméterrel: streamelés reasoning_content támogatással
  • /v1/chat/completions a tools paraméterrel: natív eszközlehívás

Kompatibilitási korlátok

Néhány apró különbség létezik:

  • A rendelkezésre álló modellek az xAI sajátjai (grok-build-0.1, grok-4.5 stb.), nem az OpenAI-é
  • Egyes kifejezetten OpenAI-specifikus paraméterek (például a logprobs) előfordulhat, hogy nem támogatottak
  • A reasoning_content az xAI API sajátossága, és nem létezik az OpenAI API-jában

Főbb megállapítások

  • Az xAI API címe https://api.x.ai/v1, és kompatibilis az OpenAI formátummal
  • A migrációhoz csak a base URL-t és az API kulcsot kell megváltoztatnod
  • Az OpenAI Python SDK változtatás nélkül működik
  • Az API kulcsot a console.x.ai oldalon szerezheted be
  • Minden OpenAI-kompatibilis szerkesztő működik az xAI-jal