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

OpenAI SDK xAI:n base_url-osoitteella

Oppitunti 5 / 12 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. OpenAI SDK:n käyttö Grokin käyttämiseen
  2. Määritykset
  3. Kutsut, jotka ovat identtisiä OpenAI:n kanssa
  4. Streamaus OpenAI SDK:lla
  5. JavaScript / TypeScript
  6. Vaihtaminen tarjoajien välillä
  7. Mitä ei siirry tarjoajien välillä
  8. Keskeiset asiat

Päivitetty 3. marraskuuta 2026. xAI:n Chat Completions -viitteiden mukaan yhteensopivuus OpenAI SDK:n kanssa ei ole “100 %”: useita parametreja ei tueta päättelymalleissa, uusimmat mallit jättävät ne huomiotta, tai mikään malli ei tue niitä. Lähde: xAI, Chat Completions.

OpenAI SDK:n käyttö Grokin käyttämiseen

Yksi xAI:n Chat Completions -päätepisteen suurimmista eduista on sen yhteensopivuus OpenAI SDK:n kanssa. Voit käyttää jo ennestään tuntemaasi openai-pakettia muuttamalla vain base_url-osoitteen osoittamaan xAI:n palvelimiin.

Tämä lähestymistapa on ihanteellinen, jos siirrät olemassa olevaa sovellusta OpenAI:lta Grokille tai haluat vaihtaa tarjoajien välillä minimaalisin muutoksin.

Määritykset

Asennus on sama kuin missä tahansa OpenAI SDK:ta käyttävässä projektissa:

pip install openai

Ainoa ero on asiakasolion luominen, jossa määrität base URL -osoitteen ja xAI:n API-avaimen:

from openai import OpenAI

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

Kaksi olennaista parametria ovat:

  • api_key: xAI:n API-avaimesi (ei OpenAI-avain)
  • base_url: https://api.x.ai/v1 – tämä ohjaa pyynnöt xAI:lle OpenAI:n sijaan

Kutsut, jotka ovat identtisiä OpenAI:n kanssa

Kun asiakasolio on määritetty, käyttö on sama kuin vakio-OpenAI SDK:ssa – lukuun ottamatta alla yksityiskohtaisesti käsiteltyjä parametreja, joita xAI ei tue:

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a technical assistant."},
        {"role": "user", "content": "What is the difference between TCP and UDP?"}
    ],
    temperature=0.7,
    max_tokens=1000
)

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

Ainoa näkyvä ero on mallin nimi: grok-4.20-0309-reasoning esimerkiksi gpt-5.6:n sijaan.

Streamaus OpenAI SDK:lla

Streamaus toimii täsmälleen samalla tavalla:

stream = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "user", "content": "Explain the concept of microservices."}
    ],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

JavaScript / TypeScript

Node.js:n OpenAI SDK toimii samalla tavalla:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: "https://api.x.ai/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4.20-0309-reasoning",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Hello, how are you?" },
  ],
});

console.log(response.choices[0].message.content);

Huomaa, että JavaScriptissä ominaisuus on baseURL (iso U), kun taas Pythonissa se on base_url.

Vaihtaminen tarjoajien välillä

Tämän lähestymistavan suurin etu on mahdollisuus vaihtaa tarjoajaa yhden muuttujan avulla:

import os
from openai import OpenAI

provider = os.getenv("LLM_PROVIDER", "xai")

configs = {
    "xai": {
        "api_key": os.getenv("XAI_API_KEY"),
        "base_url": "https://api.x.ai/v1",
        "model": "grok-4.20-0309-reasoning"
    },
    "openai": {
        "api_key": os.getenv("OPENAI_API_KEY"),
        "base_url": "https://api.openai.com/v1",
        "model": "gpt-5.6"
    }
}

config = configs[provider]
client = OpenAI(api_key=config["api_key"], base_url=config["base_url"])

Tämä monen tarjoajan arkkitehtuuri on yleinen tuotantoympäristön sovelluksissa, jotka haluavat säilyttää joustavuuden.

Mitä ei siirry tarjoajien välillä

Yhteensopiva ei tarkoita identtistä. xAI:n päätepisteen viitetiedot merkitsevät useita parametreja, joita päättelymallit eivät tue: frequency_penalty, presence_penalty (kuten grok-3:lla) ja stop. logprobs ja top_logprobs jätetään huomiotta ilman virhettä malleissa grok-4.20 ja uudemmissa, eikä logit_bias ole tuettu. Koodi, joka asettaa nämä parametrit OpenAI:lle, on poistettava ne Grokia varten. Hiljaisesti ohitetut kentät ovat hankalimpia, sillä mikään ei signaloi niiden olevan vaikuttamattomia. Isännöidyt työkalut eroavat myös tarjoajien välillä: OpenAI:n verkkohaku ei ole xAI:n verkkohaku. Lopuksi xAI luokittelee nyt Chat Completionsin vanhentuneeksi päätepisteeksi ja suosittelee Responses API:n käyttöä (tunnit 11 ja 12).

Keskeiset asiat

  • OpenAI SDK toimii xAI:n kanssa muuttamalla vain base_url osoitteeksi https://api.x.ai/v1
  • Metodit ja vastausmuodot ovat samat, mutta joitakin parametreja ei tueta (frequency_penalty, presence_penalty, stop päättelymalleissa, logit_bias) tai ne jätetään huomiotta (logprobs mallista grok-4.20 eteenpäin)
  • Muokkaa API-avain, mallinimi ja ei-tuetut parametrit
  • Tämä lähestymistapa yksinkertaistaa siirtymistä OpenAI:lta ja mahdollistaa vaihtamisen tarjoajien välillä
  • Streamaus ja OpenAI SDK:n tyypitys toimivat; isännöidyt työkalut ovat kohtaisia kullekin tarjoajalle