Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

OpenAI SDK za Grok

Lekcija 6 od 14 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Iskoristi ono što već znaš o OpenAI-u
  2. Instalacija
  3. Konfiguriraj klijenta za xAI
  4. Pošalji poruku
  5. Migriraj postojeći OpenAI projekt
  6. Razlike koje trebaš znati
  7. Kada odabrati ovaj pristup
  8. Ključne točke

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; logprobs i top_logprobs (zanemareni od grok-4.20 nadalje) te logit_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.6 i grok-4.5 ostaju dostupni)
  • grok-4.20-0309-reasoning: napredno zaključivanje
  • grok-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_penalty i presence_penalty nisu podržani na modelima za zaključivanje
  • Parametar stop nije dostupan na modelima za zaključivanje
  • logprobs i top_logprobs tiho se zanemaruju kod modela grok-4.20 i novijih, a logit_bias nije 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 konstruktor OpenAI()
  • Zamijeni API ključ i naziv modela
  • Varijable OPENAI_BASE_URL i OPENAI_API_KEY omogućuju migraciju bez diranja koda
  • Neki parametri (kazne, stop) nisu podržani na modelima za zaključivanje