OpenAI SDK Groki jaoks
Sellel lehel
Uuendatud 3. novembril 2026, lähtudes xAI Mudelite lehest: grok-4.7 (september 2026) vahetas välja grok-4.5 kui soovitatud mudeli; näide, mis on kirjutatud grok-4.5 jaoks, töötab ka grok-4.7-ga. Allikad: Mudelid · Väljalaskemärkmed.
Selgitatud 3. novembril 2026, lähtudes xAI vestluse lõpuleviimise (Chat Completions) referentsdokumendist: päring ei ole täpselt identne OpenAI omaga;
logprobsjatop_logprobs(eiratatakse alatesgrok-4.20versioonist) ninglogit_bias(ei ole toetatud) lisavad allpool loetletud erinevustele veel mõned punktid. Allikas: xAI, vestluse lõpuleviimine.
Kasuta oma OpenAI teadmisi uuesti
Kui kasutad juba Pythonis OpenAI SDK-d, saad seda muutmata kujul kasutada ka Groki API kutsumiseks. Suuna päringud lihtsalt xAI serveritesse, muutes baas-URL-i. See on kiireim viis, kui sul on olemasolev kood.
Paigaldamine
Kui OpenAI SDK pole sinu projektis veel paigaldatud:
pip install openai
Konfigureeri klient xAI jaoks
Ainus erinevus tavapärasest OpenAI kasutamisest on parameeter base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
See ongi kõik. Alates sellest hetkest töötab iga OpenAI SDK meetod Groki mudelitega.
Sõnumi saatmine
Päringu struktuur on sama mis GPT puhul, välja arvatud toetamata parameetrid (vt allpool):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "Oled tehniline assistent."},
{"role": "user", "content": "Mis vahe on REST-il ja GraphQL-il?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Saadaolevad mudelid
Asenda OpenAI mudeli nimi lihtsalt Groki mudeliga:
grok-4.7: xAI soovitatud mudel, mitmekülgne, toetab sisendina pilte (grok-4.6jagrok-4.5on samuti saadaval)grok-4.20-0309-reasoning: täiustatud arutlusvõimegrok-4.3: kiired ja odavad vastused (1M kontekst)
Olemasoleva OpenAI projekti migreerimine
Olemasoleva projekti kohandamiseks on sul kaks võimalust.
1. variant: Keskkonnamuutujad
Muuda muutujaid, puutumata koodi:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
OpenAI SDK loeb need muutujad automaatselt. Sinu olemasolev kood töötab, kui muudad ka mudeli nime ja eemaldad parameetrid, mida xAI ei toeta.
2. variant: Selge konfiguratsioon
Kirjuta initsialiseerimisfunktsioon, mis lülitab teenusepakkujate vahel:
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() # Vaikimisi OpenAI
client = create_client("xai")
See lähenemine võimaldab migreerimise käigus hõlpsasti teenusepakkujate vahel lülituda.
Teadaolevad erinevused
Kuigi API on ühilduv, erineb mõni käitumine:
- Parameetrid
frequency_penaltyjapresence_penaltyei ole toetatud arutlusvõimega mudelitel - Parameeter
stopei ole arutlusvõimega mudelitel saadaval logprobsjatop_logprobseiratakse vaikselt mudelitegrok-4.20ja uuemate poolt ninglogit_biasei ole toetatud- Mudelite nimed on ilmselgelt erinevad
- Mõned xAI funktsioonid (X otsing, veebiotsing) ei ole standardses OpenAI vormingus saadaval
Millal seda lähenemist valida
Ühilduvusrežiim on kõige mõttekam siis, kui sinu olemasolev kood on olulisem kui eksklusiivsed funktsioonid. Kõige tavalisem juhtum on migreerimine: OpenAI jaoks juba kirjutatud kood lülitub Grokile, muutes baas-URL-i ja võtit: kaks rida, ümberkirjutamist pole. Pööratavus on samuti oluline: seni kuni püsida OpenAI vormingus, jääb teenusepakkujate vahetamine konfiguratsiooni küsimuseks, mis on väärtuslik mudelite võrdlemisel või läbirääkimistel. Siis on veel ökosüsteem: OpenAI SDK ümber ehitatud kolmandate osapoolte tööriistad, nagu LangChain ja LlamaIndex, töötavad kohe ning meeskonnal, kes juba tunneb SDK-d, pole vaja midagi uut õppida. Hind, mida tuleb maksta, on see, mida eespool nägid: xAI-spetsiifilised funktsioonid jäävad tagaplaanile.
Peamised punktid
- Lisa
OpenAI()konstruktorilebase_url="https://api.x.ai/v1" - Asenda API võti ja mudeli nimi
- Muutujad
OPENAI_BASE_URLjaOPENAI_API_KEYvõimaldavad migreerimist koodi muutmata - Mõned parameetrid (trahvid, stopp) ei ole arutlusvõimega mudelitel toetatud