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

Az API alapURL-je

4. lecke 14 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. A Grok API belépési pontja
  2. Az alapURL
  3. Kompatibilitás az OpenAI ökoszisztémával
  4. A fő végpontok
  5. Az URL beállítása az SDK-kban
  6. Kapcsolódás tesztelése
  7. Korlátok és kvóták
  8. Főbb megállapítások

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/v1 cí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ása
  • POST /v1/images/edits: meglévő képek szerkesztése
  • POST /v1/videos/generations: videók generálása
  • POST /v1/tts: beszédszintézis (szövegből beszéd)

Fájlkezelés

  • POST /v1/files: fájl feltöltése
  • GET /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/completions végpont a kompatibilitás érdekében továbbra is elérhető