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

Az OpenAI SDK használata Grokhoz

6. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Használd fel az OpenAI-val kapcsolatos tudásodat
  2. Telepítés
  3. A kliens konfigurálása xAI-hoz
  4. Üzenet küldése
  5. Meglévő OpenAI projekt migrálása
  6. Ismerendő eltérések
  7. Mikor válaszd ezt a megközelítést?
  8. Főbb megállapítások

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 és top_logprobs (a grok-4.20 verziótól figyelmen kívül hagyva), valamint a logit_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 (a grok-4.6 és grok-4.5 továbbra is elérhető)
  • grok-4.20-0309-reasoning: fejlett következtetési képességek
  • grok-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 és presence_penalty paraméterek nem támogatottak a következtetési (reasoning) modelleken
  • A stop paraméter nem elérhető a következtetési modelleken
  • A logprobs és top_logprobs paramétereket a grok-4.20 és újabb modellek csendesen figyelmen kívül hagyják, a logit_bias pedig 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 az OpenAI() konstruktornak
  • Cseréld le az API-kulcsot és a modell nevét
  • Az OPENAI_BASE_URL és OPENAI_API_KEY vá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