Az API alapURL-je
Ezen az oldalon
A Grok API belépési pontja
Minden xAI API-kérés egyetlen alapURL-en keresztül fut. Mielőtt megírnád az első kódsorodat, elengedhetetlen, hogy megértsd ezt az URL-t és az elérhető végpontokat.
Az alapURL
A Grok API ezen a címen érhető el:
https://api.x.ai/v1
Ez az URL minden végpont gyökere. Például egy válasz létrehozásához a teljes URL: https://api.x.ai/v1/responses.
Miért a /v1?
A /v1 előtag az API verzióját jelöli. A verziókezelés lehetővé teszi az xAI számára, hogy fejlessze az API-t anélkül, hogy megszakítaná a meglévő alkalmazásokat. Ha megjelenik egy 2-es verzió, az egy átmeneti időszakban együtt fog létezni az v1-gyel.
Kompatibilitás az OpenAI ökoszisztémával
Az xAI API egyik alapvető tulajdonsága az OpenAI-formátummal való kompatibilitás. A gyakorlatban, ha már van olyan kódod, amely működik az OpenAI API-val, csak két beállítást kell módosítanod a Grok használatához:
- Az alapURL: cseréld le a
https://api.openai.com/v1címet erre:https://api.x.ai/v1 - Az API-kulcs: cseréld le az OpenAI-kulcsodat az xAI-kulcsodra
Ez a kompatibilitás kiterjed az OpenAI ökoszisztéma legtöbb eszközére és könyvtárára is: a LangChain, a LlamaIndex, a LiteLLM és sok más eszköz kódmódosítás nélkül működik a Grokkal.
A fő végpontok
Az API több, funkciók szerint csoportosított végpontot tesz közzé.
Szöveggenerálás
POST /v1/responses: a válaszok generálására szolgáló fő végpont (modern formátum)POST /v1/chat/completions: az OpenAI-kompatibilis végpont (örökölt formátum, továbbra is támogatott)
Médiagenerálás
POST /v1/images/generations: képek generálásaPOST /v1/images/edits: meglévő képek szerkesztésePOST /v1/videos/generations: videók generálásaPOST /v1/tts: beszédszintézis (szövegből beszéd)
Fájlkezelés
POST /v1/files: fájl feltöltéseGET /v1/files: feltöltött fájlok listázása
Valós idejű kommunikáció
wss://api.x.ai/v1/realtime: hangalapú ügynök WebSocketen keresztül
Az URL beállítása az SDK-kban
Ha OpenAI-kompatibilis SDK-t használsz, explicit módon meg kell adnod az alapURL-t:
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
A natív xAI SDK esetén az URL előre konfigurált, így semmit sem kell beállítanod.
Kapcsolódás tesztelése
Mielőtt bármilyen kódot írnál, egy közvetlen hívás validálja az egész láncot (URL, kulcs, hálózat):
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
A válasz listázza a kulcsoddal elérhető modelleket. Ez a legmegbízhatóbb módja annak, hogy megtudd a fiókodon elérhető pontos modellazonosítókat, anélkül, hogy a változható dokumentációra támaszkodnál. Tartsd meg ezt a szokást: minden új környezetet (gép, CI, szerver) ezzel a hívással validálj bármilyen telepítés előtt.
Korlátok és kvóták
Az API sebességkorlátokat (rate limits) érvényesít csapatonként és modellenként. Ha túlléped ezeket, HTTP 429-es hibát kapsz. Az xAI konzol valós időben mutatja a jelenlegi kvótáidat és a felhasználásodat.
Főbb megállapítások
- Minden végpont alapURL-je:
https://api.x.ai/v1 - Az API kompatibilis az OpenAI-formátummal: csak az URL-t és a kulcsot kell megváltoztatnod, és kész is
- A fő generálási végpont:
POST /v1/responses - Az örökölt
POST /v1/chat/completionsvégpont a kompatibilitás érdekében továbbra is elérhető