Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

API xAI za razvijalce

Lekcija 15 od 16 Posodobljeno 29. julij 2026 Začetnik
Na tej strani
  1. Vgradi Grok v svoje aplikacije
  2. Predpogoji
  3. Začetna nastavitev
  4. Tvoja prva zahteva
  5. Kaj API ponuja
  6. Izbira modela
  7. Omejitve hitrosti in najboljše prakse
  8. Ključne ugotovitve

Vgradi Grok v svoje aplikacije

Vse, kar si se naučil početi v vmesniku Grok, lahko sprožiš iz svoje kode. API xAI prinaša te zmožnosti v tvoje aplikacije, spletna mesta in storitve: pogovor preneha biti kraj, kamor greš, in postane funkcija, ki jo klice tvoj izdelek.

Predpogoji

Preden napišeš prvo vrstico kode, potrebuješ štiri stvari:

  1. Račun xAI, ustvarjen na accounts.x.ai
  2. Ključ API, generiran na console.x.ai
  3. Nastavljen način plačila (za uporabo brezplačne kvote)
  4. Razvojno okolje za Python ali JavaScript

Prvi dve stvari si v tem tečaju že opravil: račun skrbi za avtentikacijo, ključ pa tvojo aplikacijo identificira pri API-ju. Način plačila pride v poštev šele, ko tvoja uporaba preseže brezplačno kvoto, kar se zgodi hitreje, kot misliš, takoj ko storitev teče neprekinjeno. Kar zadeva okolje, imata Python in JavaScript najboljša orodja, a ker API govori HTTP, zadošča vsak jezik, ki zna poslati zahtevo.

Začetna nastavitev

Prvi korak je varno shranjevanje ključa API v spremenljivko okolja:

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

Svojega ključa nikoli ne vgrajuj neposredno v izvorno kodo. Razlog je preprost: ključ, zapisan v datoteki, prej ali slej konča v repozitoriju Git, ključ, potisnjen v javni repozitorij, pa boti, ki preiskujejo potrditve, izkoristijo v nekaj minutah, medtem ko račun ostane na tvoje ime.

Sledi izbira SDK. Domači SDK xAI za Python namestiš z pip install xai-sdk. Če tvoja koda že kliče OpenAI, knjižnica openai deluje brez sprememb, zahvaljujoč združljivosti formatov. Na strani JavaScript dodaš Vercel AI SDK z npm install ai @ai-sdk/xai, ki se integrira z aplikacijami React in Next.js.

Tvoja prva zahteva

Z domačim SDK ustvarjanje odjemalca in odpiranje pogovora zahteva tri vrstice:

from xai_sdk import Client
import os

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

Pot, združljiva z OpenAI, je enako neposredna: v primerjavi z obstoječo kodo se spremeni le base_url, zato se mnoge ekipe preklopijo v nekaj minutah.

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

Če želiš preveriti, ali ključ deluje, še preden napišeš kakšno kodo, ni nič boljšega od klica v ukazni vrstici:

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

Kaj API ponuja

Temelj je generiranje besedila (pogovorni odgovori, pisanje, analiza), skupaj z načinom razmišljanja, ki korak za korakom rešuje kompleksne probleme. Temu se pridruži pretakanje (streaming), ki odgovor dostavlja žeton za žetonom, namesto da bi čakalo na konec generiranja.

Drugi sklop omogoča dostop do informacij: iskanje po spletu in X v realnem času ter RAG, ki poizveduje po zbirkah dokumentov, ki si jih zgradil. Večmodalni vidik zajema razumevanje slik, ki jih priskrbiš, generiranje slik in videoposnetkov z grok-imagine ter glas, s pogovori v govorjeni obliki in TTS.

Končno trije mehanizmi omogočajo, da je API programirljiv v strogem smislu: klicanje funkcij, ki modelu omogoča klicanje tvojih lastnih funkcij; strukturirani izhodi, ki zagotavljajo uporaben JSON brez krhke naknadne obdelave; in izvajanje kode na strani strežnika.

Izbira modela

Razmišljanje se razlikuje glede na model. grok-4.7, vodilni model, ponuja nastavljivo razmišljanje: parameter reasoning_effort (low, medium, high ali xhigh) določa, kako globoko razmišlja, in to za vsako zahtevo posebej. grok-4.3 ostaja proračunska možnost z zelo dolgim kontekstom, pri približno polovični ceni. Obstajajo različice modelov brez razmišljanja za preproste naloge: preoblikovanje ali razvrščanje ne potrebujeta notranjega premisleka.

Poimenovanja vplivajo na stabilnost tvoje aplikacije:

  • grok-4.20: najnovejša priporočena stabilna različica
  • grok-4.20-latest: najnovejša različica (se lahko spremeni)
  • grok-4.20-0309: različica, pripeta na določen datum (9. marec)

V proizvodnem okolju pripeta različica ščiti tvoje pozive pred tihih spremembami modela; latest je v redu za raziskovanje, dokler sprejemaš, da se lahko vedenje spremeni.

Omejitve hitrosti in najboljše prakse

API uveljavlja omejitve hitrosti, da ohrani stabilnost storitve: na osnovni ravni približno 10 milijonov žetonov na minuto in 1.800 zahtev na minuto za modele, kot je grok-4.3, z višjimi omejitvami, ko napreduješ po ravneh. Modeli za generiranje slik in videoposnetkov imajo svoje, precej nižje omejitve, od 30 do 300 zahtev na minuto, odvisno od modela, zato jih pri storitvah, namenjenih končnim uporabnikom, pozorno spremljaj.

Nekaj navad loči prototip od trdne integracije. Vklopi pretakanje za dolge odgovore, ker trideset sekund gledanja v prazen zaslon deluje kot izpad. Posreduj ID pogovora za izkoriščanje predpomnjenja. Vsako nalogo usmeri k pravemu modelu: grok-4.3 za preprost obseg, grok-4.20 za razmišljanje. Napake obravnavaj s ponovnimi poskusi in eksponentnim zamikom, sicer se prometni vrh spremeni v plaz zavrnjenih zahtev. In spremljaj svojo uporabo v konzoli, preden ob koncu meseca odkriješ skupni znesek.

Ključne ugotovitve

  • API xAI je združljiv s formatom OpenAI, kar olajša selitev
  • Na voljo je več SDK-jev: domači xAI, OpenAI in Vercel AI SDK
  • API zajema besedilo, slike, video, glas in iskanje
  • Dve ravni modelov: grok-4.7 (vodilni, nastavljivo razmišljanje) in grok-4.3 (proračunski, kontekst 1M)
  • Ključ API vedno shrani v spremenljivko okolja, nikoli ga ne vgrajuj neposredno v kodo