xAI API és OpenAI-kompatibilitás
Ezen az oldalon
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:
- Base URL: cseréld le a
https://api.openai.com/v1címet erre:https://api.x.ai/v1 - API kulcs: használd az xAI API kulcsodat (a
console.x.aioldalró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
- Nyisd meg a console.x.ai oldalt
- Jelentkezz be az xAI-fiókodba (vagy hozz létre egyet az accounts.x.ai oldalon)
- Az API Keys szekcióban generálj egy új kulcsot
- 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/completionsastream: trueparaméterrel: streamelésreasoning_contenttámogatással/v1/chat/completionsatoolsparamé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_contentaz 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