OpenAI SDK za Grok
Na ovoj stranici
Ažurirano 3. studenoga 2026., na temelju stranice xAI Models: grok-4.7 (rujan 2026.) naslijedio je grok-4.5 kao preporučeni model; primjer napisan s grok-4.5 radi i s grok-4.7. Izvori: Models · Release notes.
Pojašnjeno 3. studenoga 2026., na temelju xAI referencije za Chat Completions: poziv nije strogo identičan OpenAI-jevom;
logprobsitop_logprobs(zanemareni odgrok-4.20nadalje) telogit_bias(nije podržan) dodaju se razlikama navedenima u nastavku. Izvor: xAI, Chat Completions.
Iskoristi ono što već znaš o OpenAI-u
Ako već radiš s OpenAI SDK-om u Pythonu, možeš ga koristiti kakav jest za pozivanje Grok API-ja. Samo preusmjeri zahtjeve na xAI-jeve poslužitelje promjenom osnovnog URL-a. To je najbrži pristup ako već imaš postojeći kod.
Instalacija
Ako OpenAI SDK još nije instaliran u tvom projektu:
pip install openai
Konfiguriraj klijenta za xAI
Jedina razlika u odnosu na uobičajenu upotrebu OpenAI-a je parametar base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
To je to. Od sada svaka metoda u OpenAI SDK-u radi s Grok modelima.
Pošalji poruku
Poziv ima isti oblik kao i za GPT, osim za nepodržane parametre (vidi dolje):
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)
Dostupni modeli
Samo zamijeni naziv OpenAI modela nazivom Grok modela:
grok-4.7: model koji xAI preporučuje, svestran, s unosom slike (grok-4.6igrok-4.5ostaju dostupni)grok-4.20-0309-reasoning: napredno zaključivanjegrok-4.3: brzi, jeftini odgovori (kontekst od 1M)
Migriraj postojeći OpenAI projekt
Za prilagodbu postojećeg projekta imaš dvije opcije.
Opcija 1: Varijable okruženja
Promijeni svoje varijable bez diranja koda:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
OpenAI SDK automatski čita ove varijable. Tvoj postojeći kod radit će ako također promijeniš naziv modela i ukloniš parametre koje xAI ne podržava.
Opcija 2: Eksplicitna konfiguracija
Napiši funkciju za inicijalizaciju koja se prebacuje između pružatelja usluga:
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() # OpenAI prema zadanim postavkama
client = create_client("xai")
Ovaj pristup omogućuje ti jednostavno prebacivanje između pružatelja usluga tijekom migracije.
Razlike koje trebaš znati
Iako je API kompatibilan, neka se ponašanja razlikuju:
- Parametri
frequency_penaltyipresence_penaltynisu podržani na modelima za zaključivanje - Parametar
stopnije dostupan na modelima za zaključivanje logprobsitop_logprobstiho se zanemaruju kod modelagrok-4.20i novijih, alogit_biasnije podržan- Nazivi modela su očito drugačiji
- Neke xAI značajke (X pretraživanje, web pretraživanje) nisu dostupne kroz standardni OpenAI format
Kada odabrati ovaj pristup
Način rada s kompatibilnošću ima najviše smisla kada ti je postojeći kod važniji od ekskluzivnih značajki. Najčešći slučaj je migracija: kod već napisan za OpenAI prelazi na Grok promjenom osnovnog URL-a i ključa: dva retka, bez prepisivanja. Reverzibilnost je također važna: dokle god ostaneš na OpenAI formatu, promjena pružatelja usluga ostaje pitanje konfiguracije, što je vrijedno za usporedbu modela ili pregovaranje. Tu je i ekosustav: alati trećih strana izgrađeni oko OpenAI SDK-a, poput LangChaina i LlamaIndexa, rade odmah, a tim koji već poznaje SDK nema što novo učiti. Cijena koju plaćaš je ona koju si vidio gore: xAI-jeve specifične značajke idu u drugi plan.
Ključne točke
- Dodaj
base_url="https://api.x.ai/v1"u konstruktorOpenAI() - Zamijeni API ključ i naziv modela
- Varijable
OPENAI_BASE_URLiOPENAI_API_KEYomogućuju migraciju bez diranja koda - Neki parametri (kazne, stop) nisu podržani na modelima za zaključivanje