Lähe põhisisu juurde
Eesti— Vali keel
Menüü

OpenAI SDK Groki jaoks

Õppetund 6 / 14 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Kasuta oma OpenAI teadmisi uuesti
  2. Paigaldamine
  3. Konfigureeri klient xAI jaoks
  4. Sõnumi saatmine
  5. Olemasoleva OpenAI projekti migreerimine
  6. Teadaolevad erinevused
  7. Millal seda lähenemist valida
  8. Peamised punktid

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; logprobs ja top_logprobs (eiratatakse alates grok-4.20 versioonist) ning logit_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.6 ja grok-4.5 on samuti saadaval)
  • grok-4.20-0309-reasoning: täiustatud arutlusvõime
  • grok-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_penalty ja presence_penalty ei ole toetatud arutlusvõimega mudelitel
  • Parameeter stop ei ole arutlusvõimega mudelitel saadaval
  • logprobs ja top_logprobs eiratakse vaikselt mudelite grok-4.20 ja uuemate poolt ning logit_bias ei 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() konstruktorile base_url="https://api.x.ai/v1"
  • Asenda API võti ja mudeli nimi
  • Muutujad OPENAI_BASE_URL ja OPENAI_API_KEY võimaldavad migreerimist koodi muutmata
  • Mõned parameetrid (trahvid, stopp) ei ole arutlusvõimega mudelitel toetatud