OpenAI SDK za Grok
Na tej strani
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
logprobsintop_logprobs(od različicegrok-4.20dalje se ignorirata) terlogit_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.6ingrok-4.5sta še vedno na voljo)grok-4.20-0309-reasoning: napredno sklepanjegrok-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_penaltyinpresence_penaltynista podprta pri modelih za sklepanje - Parameter
stopni na voljo pri modelih za sklepanje - Parametra
logprobsintop_logprobsmodelagrok-4.20in novejši tiho ignorirajo,logit_biaspa 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"konstruktorjuOpenAI() - Zamenjaj API ključ in ime modela
- Spremenljivki
OPENAI_BASE_URLinOPENAI_API_KEYomogočata selitev brez dotikanja kode - Nekateri parametri (kazni, stop) niso podprti pri modelih za sklepanje