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

xAI API ja OpenAI-yhteensopivuus

Oppitunti 4 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Tuttu API
  2. Minimaalinen konfiguraatio
  3. Hanki API-avain
  4. Käytettävissä olevat päätepisteet
  5. Yhteensopivuusrajoitukset
  6. Keskeiset asiat

Tuttu API

xAI:n API käyttää samaa muotoa kuin OpenAI:n API. Jos olet aiemmin työskennellyt OpenAI:n API:n tai yhteensopivien työkalujen kanssa, sinun ei tarvitse opetella mitään uutta. Ainoa asia, joka muuttuu, on perus-URL-osoite.

https://api.x.ai/v1

Tämä yhteensopivuus on xAI:n strateginen valinta. Uuden suljetun muodon sijaan he omaksuivat alan epävirallisen standardin. Tämän ansiosta mikä tahansa työkalu, SDK tai editori, joka tukee OpenAI:n API:a, voi käyttää grok-build-0.1-mallia välittömästi.

Minimaalinen konfiguraatio

Vaihtaaksesi OpenAI:sta xAI:hon missä tahansa yhteensopivassa asiakasohjelmassa, sinun tarvitsee muuttaa vain kahta parametria:

  1. Perus-URL: korvaa https://api.openai.com/v1 osoitteella https://api.x.ai/v1
  2. API-avain: käytä xAI:n API-avaintasi (saat sen osoitteesta console.x.ai)

Kaikki muu – viestien muoto, lämpötilaparametrit ja vastauksen rakenne – on identtinen.

Esimerkki OpenAI:n Python-SDK:lla

from openai import OpenAI

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

response = client.chat.completions.create(
    model="grok-build-0.1",
    messages=[
        {"role": "system", "content": "You are a programming assistant."},
        {"role": "user", "content": "Write a quicksort function in Python."}
    ]
)

Käytät standardia OpenAI-SDK:ta ilman muutoksia. Vain base_url ja mallin nimi muuttuvat.

Esimerkki curlilla

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer your-xai-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-build-0.1",
    "messages": [
      {"role": "user", "content": "Explain the difference between let and const in JavaScript"}
    ]
  }'

Hanki API-avain

  1. Siirry osoitteeseen console.x.ai
  2. Kirjaudu sisään xAI-tililläsi (tai luo tili osoitteessa accounts.x.ai)
  3. Luo uusi avain API Keys -osiossa
  4. Kopioi se heti – sitä ei näytetä uudelleen

Pidä tämä avain turvassa. Älä koskaan commitoi sitä Git-varastoon tai jaa sitä tiimin chatissa. Käytä ympäristömuuttujaa tai salaisuuksien hallintatyökalua.

Käytettävissä olevat päätepisteet

grok-build-0.1 tukee seuraavia päätepisteitä, jotka kaikki noudattavat OpenAI-muotoa:

  • /v1/chat/completions: tekstin ja koodin generointi (käytetyin)
  • /v1/chat/completions parametrilla stream: true: suoratoisto mukana reasoning_content
  • /v1/chat/completions parametrilla tools: natiivi työkalukutsujen tuki

Yhteensopivuusrajoitukset

Joitakin pieniä eroja on olemassa:

  • Käytettävissä olevat mallit ovat xAI:n omia (grok-build-0.1, grok-4.5 jne.), eivät OpenAI:n
  • Jotkut vain OpenAI:lle tarkoitetut parametrit (kuten logprobs) eivät välttämättä ole tuettuja
  • reasoning_content on spesifi xAI:n API:lle eikä sitä ole olemassa OpenAI:n API:ssa

Keskeiset asiat

  • xAI:n API osoitteessa https://api.x.ai/v1 on yhteensopiva OpenAI-muodon kanssa
  • Siirtyminen vaatii vain perus-URL:n ja API-avaimen vaihtamisen
  • OpenAI:n Python-SDK toimii sellaisenaan
  • Saat API-avaimen osoitteesta console.x.ai
  • Kaikki OpenAI-yhteensopivat editorit toimivat xAI:n kanssa