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

xAI API arendajatele

Õppetund 15 / 16 Värskendatud 29. juuli 2026 Algajatele
Sellel lehel
  1. Groki rakendustesse lõimimine
  2. Eeltingimused
  3. Esmane seadistamine
  4. Sinu esimene päring
  5. Mida API pakub
  6. Vali oma mudel
  7. Kiirusepiirangud ja parimad tavad
  8. Peamised punktid

Groki rakendustesse lõimimine

Kõike, mida oled õppinud Groki liideses tegema, saab käivitada oma koodist. xAI API toob need võimalused sinu rakendustesse, veebisaitidesse ja teenustesse: vestlus ei ole enam koht, kuhu minnakse, vaid funktsioon, mida sinu toode kutsub.

Eeltingimused

Enne esimese koodirea kirjutamist on vaja nelja asja:

  1. xAI konto, loodud aadressil accounts.x.ai
  2. API võti, genereeritud console.x.ai lehel
  3. Makseviisi seadistamine (et ületada tasuta kvooti)
  4. Pythoni või JavaScripti arenduskeskkond

Esimesed kaks on asjad, mille oled selles kursuses juba ära teinud: konto haldab autentimist ja võti identifitseerib sinu rakenduse API-le. Makseviis tuleb mängu alles siis, kui sinu kasutus ületab tasuta kvoodi, mis juhtub kiiremini, kui arvad, niipea kui teenus töötab pidevalt. Mis puutub keskkonda, siis Pythonil ja JavaScriptil on parimad tööriistad, kuid kuna API kasutab HTTP-d, sobib iga keel, mis suudab päringu saata.

Esmane seadistamine

Esimene samm on oma API võtme turvaline salvestamine keskkonnamuutujasse:

export XAI_API_KEY="xai-your-key-here"

Ära kunagi kodeeri oma võtit otse lähtekoodi. Põhjus on proosaline: faili kirjutatud võti satub varem või hiljem Git’i hoidlasse ja avalikku hoidlasse lükatud võtit kuritarvitavad minutitega botid, mis skaneerivad commit’e, samas kui arve jääb sinu nimele.

Järgmiseks tuleb valida SDK. Native xAI SDK Pythonile installitakse käsuga pip install xai-sdk. Kui sinu kood juba kutsub OpenAI-d, töötab openai teek muutusteta tänu vormingu ühilduvusele. JavaScripti poolel lisad Vercel AI SDK käsuga npm install ai @ai-sdk/xai ja see integreerub Reacti ja Next.jsi rakendustega.

Sinu esimene päring

Native SDK-d kasutades võtab kliendi loomine ja vestluse avamine kolm rida:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")

OpenAI-ga ühilduv tee on sama otsene: muutub vaid base_url võrreldes olemasoleva koodiga, mistõttu paljud meeskonnad vahetavad selle paari minutiga üle.

from openai import OpenAI
import os

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

response = client.responses.create(
    model="grok-4.5",
    input="Explain machine learning to me in 3 sentences."
)

Et kontrollida, kas võti töötab enne, kui üldse koodi kirjutad, ei ole midagi paremat kui käsurea kutse:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Hi, how are you?"
  }'

Mida API pakub

Aluseks on teksti genereerimine (vestlusvastused, kirjutamine, analüüs), millele lisandub arutlusrežiim, mis lahendab keerulisi probleeme samm-sammult. Voogedastus (streaming) täiendab seda, edastades vastuse tokeni haaval, ootamata genereerimise lõppu.

Teine komplekt annab juurdepääsu informatsioonile: reaalajas veebi- ja X-i otsing ning RAG, mis päringutab sinu loodud dokumentide kogumeid. Multimeedia külg hõlmab sinu pakutavate piltide mõistmist, piltide ja videote genereerimist grok-imagine’iga ning häält, sealhulgas kõnelisi vestlusi ja TTS-i.

Lõpuks muudavad API programmeeritavaks kitsamas tähenduses kolm mehhanismi: funktsioonide kutsumine, mis võimaldab mudelil kutsuda sinu enda funktsioone; struktureeritud väljundid, mis tagavad kasutatava JSON-i ilma habra järeltöötluseta; ja serveripoolne koodi täitmine.

Vali oma mudel

Arutlusvõime erineb mudeliti. grok-4.7, lipulaev, pakub konfigureeritavat arutlust: parameeter reasoning_effort (low, medium, high või xhigh) määrab, kui sügavalt ta mõtleb, päring haaval. grok-4.3 jääb eelarvesõbralikuks, väga pika konteksti valikuks, makstes umbes poole vähem. Mudelite olemas on ka mitte-arutlevad versioonid lihtsate ülesannete jaoks: ümber sõnastamine või klassifitseerimine ei vaja sisemist arutlemist.

Nimede konventsioonid mõjutavad sinu rakenduse stabiilsust:

  • grok-4.20: viimane soovitatud stabiilne versioon
  • grok-4.20-latest: kõige uuem versioon (võib muutuda)
  • grok-4.20-0309: kindlale kuupäevale (9. märts) lukustatud versioon

Tootmiskeskkonnas kaitseb lukustatud versioon sinu prompte mudeli vaiksete muudatuste eest; latest sobib uurimistööks, kui oled nõus, et käitumine võib muutuda.

Kiirusepiirangud ja parimad tavad

API rakendab kiirusepiiranguid, et hoida teenus stabiilsena: sisetasemel umbes 10 miljonit tokenit minutis ja 1800 päringut minutis selliste mudelite nagu grok-4.3 puhul, ning rohkem, kui sinu tase tõuseb. Piltide ja videote genereerimise mudelitel on oma, palju madalamad laed, 30–300 päringut minutis olenevalt mudelist, nii et tarbijale suunatud teenuse puhul pea neid silmas.

Mõned harjumused eristavad prototüüpi kindlast integratsioonist. Lülita voogedastus sisse pikkade vastuste jaoks, sest kolmkümmend sekundit tühja ekraani ees tundub nagu katkestus. Edasta vestluse ID, et kasutada vahemällu salvestamist. Suuna iga ülesanne õigele mudelile: grok-4.3 lihtsa mahu jaoks, grok-4.20 arutluse jaoks. Käitle vigu uuestiproovimiste ja eksponentsiaalse tagasiminekuga (exponential backoff), muidu muutub liikluse tipp tagasilükatud päringute laviiniks. Ja jälgi oma kasutust konsoolis, enne kui avastad kogusumma kuu lõpus.

Peamised punktid

  • xAI API on ühilduv OpenAI vorminguga, mis muudab migratsiooni lihtsaks
  • Saadaval on mitu SDK-d: native xAI, OpenAI ja Vercel AI SDK
  • API hõlmab teksti, pilte, videot, häält ja otsingut
  • Kaks mudelite taset: grok-4.7 (lipulaev, konfigureeritav arutlus) ja grok-4.3 (eelarve, 1M kontekst)
  • Salvesta oma API võti alati keskkonnamuutujasse, mitte kunagi otse koodi