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

xAI API ja OpenAI ühilduvus

Õppetund 4 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Tuttav API
  2. Minimaalne konfiguratsioon
  3. API võtme hankimine
  4. Saadaolevad lõpp-punktid
  5. Ühilduvuse piirangud
  6. Peamised punktid

Tuttav API

xAI API kasutab sama vormingut kui OpenAI API. Kui oled varem töötanud OpenAI API või sellega ühilduvate tööriistadega, pole sul midagi uut õppida. Ainus, mis muutub, on baas-URL.

https://api.x.ai/v1

See ühilduvus on xAI strateegiline valik. Uue omanikulise vormingu pealesurumise asemel võtsid nad kasutusele de facto tööstusstandardi. Seetõttu saab iga tööriist, SDK või redaktor, mis toetab OpenAI API-d, kohe kasutada mudelit grok-build-0.1.

Minimaalne konfiguratsioon

Et lülituda OpenAI-lt xAI-le mis tahes ühilduvas kliendis, pead muutma vaid kahte parameetrit:

  1. Baas-URL: asenda https://api.openai.com/v1 aadressiga https://api.x.ai/v1
  2. API võti: kasuta oma xAI API võtit (saadud aadressilt console.x.ai)

Kõik muu – sõnumite vorming, temperatuuri parameetrid, vastuse struktuur – on identne.

Näide OpenAI Python SDK-ga

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."}
    ]
)

Kasutad standardset OpenAI SDK-d ilma igasuguste muudatusteta. Muutuvad vaid base_url ja mudeli nimi.

Näide curl-iga

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"}
    ]
  }'

API võtme hankimine

  1. Mine aadressile console.x.ai
  2. Logi sisse oma xAI kontoga (või loo konto aadressil accounts.x.ai)
  3. Sektsioonis API Keys genereeri uus võti
  4. Kopeeri see kohe – seda enam uuesti ei näidata

Hoia seda võtit turvaliselt. Ära kunagi salvesta seda Git-i hoidlasse ega jaga meeskonna vestluses. Kasuta keskkonnamuutujat või saladuste haldurit.

Saadaolevad lõpp-punktid

grok-build-0.1 toetab järgmisi lõpp-punkte, kõik OpenAI vormingus:

  • /v1/chat/completions: teksti ja koodi genereerimine (kõige sagedamini kasutatav)
  • /v1/chat/completions parameetriga stream: true: voogedastus koos reasoning_content-iga
  • /v1/chat/completions parameetriga tools: loomulik tööriistade kutsumine

Ühilduvuse piirangud

Eksisteerib mõni väike erinevus:

  • Saadaolevad mudelid on xAI omad (grok-build-0.1, grok-4.5 jne), mitte OpenAI omad
  • Mõned OpenAI-spetsiifilised parameetrid (nagu logprobs) ei pruugi olla toetatud
  • reasoning_content on spetsiifiline xAI API-le ja seda OpenAI API-s ei eksisteeri

Peamised punktid

  • xAI API asub aadressil https://api.x.ai/v1 ja on ühilduv OpenAI vorminguga
  • Üleminekuks tuleb muuta vaid baas-URL ja API võti
  • OpenAI Python SDK töötab kohe
  • Hangi API võti aadressilt console.x.ai
  • Kõik OpenAI-ga ühilduvad redaktorid töötavad xAI-ga