Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

OpenAI SDK Grokia varten

Oppitunti 6 / 14 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Hyödynnä OpenAI-tuntemustasi
  2. Asennus
  3. Asiakkaan konfigurointi xAI:ta varten
  4. Viestin lähetys
  5. Olemassa olevan OpenAI-projektin siirtäminen
  6. Huomioitavat erot
  7. Milloin valita tämä lähestymistapa
  8. Keskeiset asiat

Päivitetty 3. marraskuuta 2026 xAI:n Models-sivun perusteella: grok-4.7 (syyskuu 2026) korvasi grok-4.5:n suositeltuna mallina; esimerkki, joka on kirjoitettu grok-4.5:lle, toimii myös grok-4.7:n kanssa. Lähteet: Models · Release notes.

Selvennetty 3. marraskuuta 2026 xAI:n Chat Completions -viitteen perusteella: kutsu ei ole täysin identtinen OpenAI:n kanssa; logprobs ja top_logprobs (jätetään huomiotta mallista grok-4.20 alkaen) sekä logit_bias (ei tuettu) lisäävät alla lueteltuihin eroihin. Lähde: xAI, Chat Completions.

Hyödynnä OpenAI-tuntemustasi

Jos käytät jo OpenAI SDK:ta Pythonissa, voit käyttää sitä sellaisenaan Grok API:n kutsumiseen. Ohjaa pyynnöt vain xAI:n palvelimille muuttamalla base URL -osoitetta. Tämä on nopein tapa, jos sinulla on olemassa olevaa koodia.

Asennus

Jos OpenAI SDK:ta ei ole vielä asennettu projektiisi:

pip install openai

Asiakkaan konfigurointi xAI:ta varten

Ainoa ero tavanomaiseen OpenAI-käyttöön on base_url-parametri:

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

Siinä kaikki. Tästä eteenpäin kaikki OpenAI SDK:n metodit toimivat Grok-mallien kanssa.

Viestin lähetys

Kutsu näyttää samalta kuin GPT:n kohdalla, lukuun ottamatta tukemattomia parametreja (katso alta):

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "system", "content": "Olet tekninen avustaja."},
        {"role": "user", "content": "Mikä on ero REST:n ja GraphQL:n välillä?"}
    ],
    temperature=0.7,
    max_completion_tokens=500
)

print(response.choices[0].message.content)

Käytettävissä olevat mallit

Korvaa OpenAI-mallin nimi Grok-mallilla:

  • grok-4.7: xAI:n suosittelema malli, monipuolinen, tukee kuvasyötettä (grok-4.6 ja grok-4.5 ovat edelleen saatavilla)
  • grok-4.20-0309-reasoning: edistynyt päättelykyky
  • grok-4.3: nopeat ja edulliset vastaukset (1M konteksti)

Olemassa olevan OpenAI-projektin siirtäminen

Olemassa olevan projektin mukauttamiseen sinulla on kaksi vaihtoehtoa.

Vaihtoehto 1: Ympäristömuuttujat

Muuta muuttujiasi koskematta koodiin:

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

OpenAI SDK lukee nämä muuttujat automaattisesti. Olemassa oleva koodisi toimii, jos muutat myös mallin nimen ja poistat parametrit, joita xAI ei tue.

Vaihtoehto 2: Eksplisiittinen konfigurointi

Kirjoita alustusfunktio, joka vaihtaa tarjoajien välillä:

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 oletuksena

client = create_client("xai")

Tämä lähestymistapa mahdollistaa helpon vaihtamisen tarjoajien välillä siirtymävaiheen aikana.

Huomioitavat erot

Vaikka API on yhteensopiva, jotkin toimintatavat eroavat toisistaan:

  • Parametrit frequency_penalty ja presence_penalty eivät ole tuettuja päättelymalleissa
  • Parametri stop ei ole käytettävissä päättelymalleissa
  • logprobs ja top_logprobs jätetään hiljaisesti huomiotta malleissa grok-4.20 ja uudemmissa, eikä logit_bias ole tuettu
  • Mallien nimet ovat luonnollisesti erilaisia
  • Jotkut xAI:n ominaisuudet (X-haku, verkkohaku) eivät ole käytettävissä standardin OpenAI-muodon kautta

Milloin valita tämä lähestymistapa

Yhteensopivuustila on järkevin silloin, kun olemassa oleva koodisi on tärkeämpää kuin eksklusiiviset ominaisuudet. Yleisin tapaus on migraatio: OpenAI:ta varten jo kirjoitettu koodi siirtyy Grokiin muuttamalla base URL -osoitetta ja avainta: kaksi riviä, ei uudelleenkirjoitusta. Palautettavuus on myös tärkeää: niin kauan kuin pysyt OpenAI-muodossa, tarjoajan vaihtaminen on vain konfiguraatiokysymys, mikä on arvokasta malleja vertaillessa tai neuvoteltaessa. Sitten on ekosysteemi: OpenAI SDK:n ympärille rakennetut kolmansien osapuolten työkalut, kuten LangChain ja LlamaIndex, toimivat välittömästi, ja tiimi, joka jo tuntee SDK:n, ei joudu opettelemaan mitään uutta. Hintana on se, mitä näit yllä: xAI:n omat ominaisuudet jäävät taka-alalle.

Keskeiset asiat

  • Lisää base_url="https://api.x.ai/v1" OpenAI()-konstruktoriin
  • Vaihda API-avain ja mallin nimi
  • Muuttujat OPENAI_BASE_URL ja OPENAI_API_KEY mahdollistavat siirtymisen koskematta koodiin
  • Jotkut parametrit (rangaistukset, stop) eivät ole tuettuja päättelymalleissa