Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

xAI API za programere

Lekcija 15 od 16 Ažurirano 29. srpnja 2026. Početnik
Na ovoj stranici
  1. Ugradi Grok u svoje aplikacije
  2. Preduvjeti
  3. Početno postavljanje
  4. Tvoj prvi zahtjev
  5. Što API izlaže
  6. Odaberi svoj model
  7. Ograničenja stope i najbolje prakse
  8. Ključne točke

Ugradi Grok u svoje aplikacije

Sve što si naučio raditi u sučelju Groka možeš pokrenuti iz vlastitog koda. xAI API prenosi te mogućnosti u tvoje aplikacije, web stranice i servise: razgovor prestaje biti mjesto koje posjećuješ i postaje funkcija koju tvoj proizvod poziva.

Preduvjeti

Prije nego napišeš prvi redak koda, trebaš četiri stvari:

  1. xAI račun stvoren na accounts.x.ai
  2. API ključ generiran na console.x.ai
  3. Postavljen način plaćanja (za korištenje izvan besplatne kvote)
  4. Razvojno okruženje za Python ili JavaScript

Prve dvije stvari već si obavio u ovom tečaju: račun upravlja autentifikacijom, a ključ identificira tvoju aplikaciju prema API-ju. Način plaćanja postaje važan tek kada tvoja potrošnja prijeđe besplatnu kvotu, što se događa brže nego što misliš čim servis radi kontinuirano. Što se tiče okruženja, Python i JavaScript imaju najbolje alate, no budući da API komunicira putem HTTP-a, poslužit će bilo koji jezik koji može poslati zahtjev.

Početno postavljanje

Prvi korak je sigurno pohranjivanje tvog API ključa u varijablu okruženja:

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

Nikada nemoj hard-kodirati svoj ključ u izvornom kodu. Razlog je jednostavan: ključ zapisan u datoteci prije ili kasnije završi u Git repozitoriju, a ključ poslan u javni repozitorij botovi koji skeniraju commitove iskoriste unutar nekoliko minuta, dok račun ostaje na tvoje ime.

Sljedeći korak je odabir SDK-a. Izvorni xAI SDK za Python instalira se s pip install xai-sdk. Ako tvoj kod već poziva OpenAI, biblioteka openai radi odmah, zahvaljujući kompatibilnosti formata. Na strani JavaScripta, dodaješ Vercel AI SDK s npm install ai @ai-sdk/xai, a on se integrira s React i Next.js aplikacijama.

Tvoj prvi zahtjev

S izvornim SDK-om, stvaranje klijenta i otvaranje razgovora zahtijeva tri retka:

from xai_sdk import Client
import os

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

Put kompatibilan s OpenAI-jem jednako je izravan: mijenja se samo base_url u usporedbi s postojećim kodom, zbog čega mnogi timovi prijeđu na njega u nekoliko minuta.

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

Da provjeriš radi li ključ prije nego uopće napišeš ikakav kod, ništa nije bolje od poziva putem naredbenog retka:

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

Što API izlaže

Temelj je generiranje teksta (konverzacijski odgovori, pisanje, analiza), uz način rezoniranja koji rješava složene probleme korak po korak. Streamanje tome dodaje isporuku odgovora token po token umjesto čekanja da generiranje završi.

Drugi skup daje pristup informacijama: pretraživanje weba i platforme X u stvarnom vremenu te RAG, koji upituje kolekcije dokumenata koje si izgradio. Multimodalni aspekt pokriva razumijevanje slika koje pružiš, generiranje slika i videa s grok-imagine te glas, s govornim razgovorima i TTS-om.

Konačno, tri mehanizma čine API programabilnim u strogom smislu: pozivanje funkcija, koje modelu omogućuje pozivanje tvojih vlastitih funkcija; strukturirani izlazi, koji jamče upotrebljivi JSON bez krhkog naknadnog procesuiranja; i izvršavanje koda na strani poslužitelja.

Odaberi svoj model

Rezoniranje varira ovisno o modelu. grok-4.7, vodeći model, nudi konfigurabilno rezoniranje: parametar reasoning_effort (low, medium, high ili xhigh) postavlja koliko duboko model razmišlja, zahtjev po zahtjev. grok-4.3 ostaje opcija proračunske klase s vrlo dugim kontekstom, po otprilike pola cijene. Postoje i verzije modela bez rezoniranja za jednostavne zadatke: preformuliranje ili klasifikacija ne zahtijevaju unutarnje promišljanje.

Konvencije imenovanja utječu na stabilnost tvoje aplikacije:

  • grok-4.20: najnovija preporučena stabilna verzija
  • grok-4.20-latest: najnovija verzija (može se mijenjati)
  • grok-4.20-0309: verzija fiksirana na određeni datum (9. ožujka)

U proizvodnji, fiksirana verzija štiti tvoje promptove od tihih promjena u modelu; latest je u redu za istraživanje, sve dok prihvaćaš da se ponašanje može promijeniti.

Ograničenja stope i najbolje prakse

API nameće ograničenja stope kako bi održao stabilnost servisa: na osnovnoj razini, oko 10 milijuna tokena u minuti i 1.800 zahtjeva u minuti za modele poput grok-4.3, a više kako tvoja razina raste. Modeli za generiranje slika i videa imaju vlastita, mnogo niža ograničenja, od 30 do 300 zahtjeva u minuti ovisno o modelu, zato ih pomno prati za servise usmjerene na krajnje korisnike.

Nekoliko navika razdvaja prototip od čvrste integracije. Uključi streamanje za duge odgovore jer trideset sekundi gledanja u prazan zaslon djeluje kao prekid rada. Proslijedi ID razgovora kako bi iskoristio prednosti keširanja. Usmjeri svaki zadatak na pravi model: grok-4.3 za jednostavan obujam, grok-4.20 za rezoniranje. Rukuj pogreškama s ponovnim pokušajima i eksponencijalnim odgađanjem (exponential backoff), inače će se skok prometa pretvoriti u lavinu odbijenih zahtjeva. I prati svoju potrošnju u konzoli prije nego otkriješ ukupni iznos na kraju mjeseca.

Ključne točke

  • xAI API kompatibilan je s OpenAI formatom, što olakšava migraciju
  • Dostupno je nekoliko SDK-ova: izvorni xAI, OpenAI i Vercel AI SDK
  • API pokriva tekst, slike, video, glas i pretraživanje
  • Dvije razine modela: grok-4.7 (vodeći, konfigurabilno rezoniranje) i grok-4.3 (proračunski, 1M konteksta)
  • Uvijek pohrani svoj API ključ u varijablu okruženja, nikada ga nemoj hard-kodirati