Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

OpenAI SDK za Grok

Lekcija 6 od 14 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Ponovno uporabi svoje znanje o OpenAI
  2. Namestitev
  3. Konfiguracija odjemalca za xAI
  4. Pošiljanje sporočila
  5. Selitev obstoječega projekta OpenAI
  6. Razlike, ki jih moraš poznati
  7. Kdaj izbrati ta pristop
  8. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi strani xAI Models: model grok-4.7 (september 2026) je nasledil grok-4.5 kot priporočeni model; primer, napisan za grok-4.5, deluje tudi z grok-4.7. Viri: Models · Release notes.

Pojasnjeno 3. novembra 2026 na podlagi referenčne dokumentacije xAI Chat Completions: klic ni strogo identičen OpenAI-jevemu; parametra logprobs in top_logprobs (od različice grok-4.20 dalje se ignorirata) ter logit_bias (ni podprt) prispevata k razlikam, naštetim spodaj. Vir: xAI, Chat Completions.

Ponovno uporabi svoje znanje o OpenAI

Če že delaš z OpenAI SDK v Pythonu, ga lahko uporabiš takšnega, kot je, za klicanje Grok API-ja. Zahteve preusmeriš na strežnike xAI tako, da spremeniš osnovni URL. To je najhitrejši pristop, če imaš obstoječo kodo.

Namestitev

Če OpenAI SDK še ni nameščen v tvojem projektu:

pip install openai

Konfiguracija odjemalca za xAI

Edina razlika glede na običajno uporabo OpenAI je parameter 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 vse. Od tega trenutka naprej vsaka metoda v OpenAI SDK deluje z modeli Grok.

Pošiljanje sporočila

Klic ima enako strukturo kot pri GPT, razen za nepodprte parametre (glej spodaj):

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)

Razpoložljivi modeli

Preprosto zamenjaj ime modela OpenAI z modelom Grok:

  • grok-4.7: model, ki ga priporoča xAI, vsestranski, s podporo za vnos slik (grok-4.6 in grok-4.5 sta še vedno na voljo)
  • grok-4.20-0309-reasoning: napredno sklepanje
  • grok-4.3: hitri in poceni odgovori (kontekst 1M)

Selitev obstoječega projekta OpenAI

Za prilagoditev obstoječega projekta imaš dve možnosti.

1. možnost: Spremenljivke okolja

Spremeni spremenljivke brez dotikanja kode:

export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"

OpenAI SDK te spremenljivke prebere samodejno. Tvoja obstoječa koda bo delovala, če spremeniš tudi ime modela in odstraniš parametre, ki jih xAI ne podpira.

2. možnost: Eksplicitna konfiguracija

Napiši inicializacijsko funkcijo, ki preklopi med ponudniki:

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()  # Privzeto OpenAI

client = create_client("xai")

Ta pristop ti omogoča enostavno preklapljanje med ponudniki med selitvijo.

Razlike, ki jih moraš poznati

Čeprav je API združljiv, se nekatera vedenja razlikujejo:

  • Parametra frequency_penalty in presence_penalty nista podprta pri modelih za sklepanje
  • Parameter stop ni na voljo pri modelih za sklepanje
  • Parametra logprobs in top_logprobs modela grok-4.20 in novejši tiho ignorirajo, logit_bias pa ni podprt
  • Imena modelov so seveda drugačna
  • Nekatere funkcije xAI (iskanje po X, spletno iskanje) niso na voljo prek standardnega formata OpenAI

Kdaj izbrati ta pristop

Način združljivosti ima največ smisla, ko je tvoja obstoječa koda pomembnejša od ekskluzivnih funkcij. Najpogostejši primer je selitev: koda, že napisana za OpenAI, preklopi na Grok s spremembo osnovnega URL-ja in ključa: dve vrstici, brez prepisovanja. Pomembna je tudi reverzibilnost: dokler ostaneš pri formatu OpenAI, je zamenjava ponudnika zgolj stvar konfiguracije, kar je dragoceno za primerjavo modelov ali pogajanja. Tu je še ekosistem: orodja tretjih strani, zgrajena okoli OpenAI SDK, kot sta LangChain in LlamaIndex, delujejo takoj, ekipa, ki že pozna SDK, pa se ne mora učiti ničesar novega. Cena, ki jo plačaš, je tista, ki si jo videl zgoraj: funkcije, specifične za xAI, gredo v drugi plan.

Ključne ugotovitve

  • Dodaj base_url="https://api.x.ai/v1" konstruktorju OpenAI()
  • Zamenjaj API ključ in ime modela
  • Spremenljivki OPENAI_BASE_URL in OPENAI_API_KEY omogočata selitev brez dotikanja kode
  • Nekateri parametri (kazni, stop) niso podprti pri modelih za sklepanje