Az OpenAI SDK használata Grokhoz
Ezen az oldalon
Frissítve: 2026. november 3., az xAI Models oldala alapján: a grok-4.7 (2026. szeptember) váltotta a grok-4.5-öt ajánlott modellként; a grok-4.5-tel írt példa a grok-4.7-tel is működik. Források: Models · Release notes.
Tisztázva: 2026. november 3., az xAI Chat Completions hivatkozás alapján: a hívás nem teljesen azonos az OpenAI-éval; a
logprobséstop_logprobs(agrok-4.20verziótól figyelmen kívül hagyva), valamint alogit_bias(nem támogatott) további eltéréseket jelentenek az alábbiakhoz képest. Forrás: xAI, Chat Completions.
Használd fel az OpenAI-val kapcsolatos tudásodat
Ha már dolgoztál az OpenAI Python SDK-jával, változtatás nélkül használhatod a Grok API hívásához. Csak irányítsd át a kéréseket az xAI szervereire az alapértelmezett URL módosításával. Ez a leggyorsabb megoldás, ha van már meglévő kódod.
Telepítés
Ha az OpenAI SDK még nincs telepítve a projektedben:
pip install openai
A kliens konfigurálása xAI-hoz
Az egyetlen eltérés a szokásos OpenAI-használathoz képest a base_url paraméter:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Ennyi az egész. Innentől kezdve az OpenAI SDK minden metódusa működik a Grok modellekkel.
Üzenet küldése
A hívás felépítése megegyezik a GPT-vel használttal, kivéve a nem támogatott paramétereket (lásd lentebb):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Elérhető modellek
Cseréld le az OpenAI modellnevét egy Grok modellre:
grok-4.7: az xAI által ajánlott modell, sokoldalú, képes képfeldolgozásra (agrok-4.6ésgrok-4.5továbbra is elérhető)grok-4.20-0309-reasoning: fejlett következtetési képességekgrok-4.3: gyors, költséghatékony válaszok (1M kontextus)
Meglévő OpenAI projekt migrálása
Egy meglévő projekt adaptálására két lehetőséged van.
1. lehetőség: Környezeti változók
Módosítsd a változókat a kód érintése nélkül:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
Az OpenAI SDK automatikusan beolvassa ezeket a változókat. A meglévő kódod működni fog, ha átírod a modell nevét, és eltávolítod az xAI által nem támogatott paramétereket.
2. lehetőség: Explicit konfiguráció
Írj egy inicializáló függvényt, amely vált a szolgáltatók között:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # Alapértelmezett: OpenAI
client = create_client("xai")
Ez a megközelítés lehetővé teszi, hogy a migráció során könnyen válts a szolgáltatók között.
Ismerendő eltérések
Bár az API kompatibilis, egyes viselkedések eltérnek:
- A
frequency_penaltyéspresence_penaltyparaméterek nem támogatottak a következtetési (reasoning) modelleken - A
stopparaméter nem elérhető a következtetési modelleken - A
logprobséstop_logprobsparamétereket agrok-4.20és újabb modellek csendesen figyelmen kívül hagyják, alogit_biaspedig nem támogatott - A modellnevek természetesen eltérnek
- Egyes xAI-specifikus funkciók (X keresés, webes keresés) nem érhetők el a szabványos OpenAI formátumon keresztül
Mikor válaszd ezt a megközelítést?
A kompatibilitási mód akkor a legértelmesebb, ha a meglévő kódod fontosabb, mint a kizárólagos funkciók. A leggyakoribb eset a migráció: az OpenAI-ra írt kód az alapURL és a kulcs megváltoztatásával tér át a Grokra: két sor, újraírás nélkül. A visszafordíthatóság is számít: amíg az OpenAI formátumot használod, a szolgáltatóváltás csupán konfiguráció kérdése, ami értékes modellek összehasonlításához vagy tárgyalásokhoz. Ott van még az ökoszisztéma is: az OpenAI SDK köré épült harmadik féltől származó eszközök, mint például a LangChain és a LlamaIndex, azonnal működnek, és egy csapatnak, amely már ismeri az SDK-t, nem kell semmi újat tanulnia. Az ára ennek az, amit fentebb láttál: az xAI-specifikus funkciók háttérbe szorulnak.
Főbb megállapítások
- Add hozzá a
base_url="https://api.x.ai/v1"paramétert azOpenAI()konstruktornak - Cseréld le az API-kulcsot és a modell nevét
- Az
OPENAI_BASE_URLésOPENAI_API_KEYváltozók lehetővé teszik a migrációt a kód módosítása nélkül - Egyes paraméterek (büntetések, stop) nem támogatottak a következtetési modelleken