xAI API kūrėjams
Šiame puslapyje
Integruok „Grok“ į savo programas
Viską, ko išmokai daryti „Grok“ sąsajoje, galima suaktyvinti tiesiai iš savo kodo. xAI API perkelia šias galimybes į tavo programas, svetaines ir paslaugas: pokalbis nustoja būti vieta, į kurią eini, ir tampa funkcija, kurią kviečia tavo produktas.
Būtinos sąlygos
Prieš rašydamas pirmąją kodo eilutę, tau reikia keturių dalykų:
- xAI paskyros, sukurtos adresu accounts.x.ai
- API rakto, sugeneruoto console.x.ai
- Nustatyto mokėjimo būdo (norint viršyti nemokamą kvotą)
- Python arba JavaScript kūrimo aplinkos
Pirmieji du žingsniai jau atlikti šiame kurse: paskyra tvarko autentifikavimą, o raktas identifikuoja tavo programą API sąsajoje. Mokėjimo būdas taps aktualus tik tada, kai naudojimas viršys nemokamą kvotą, o tai nutinka greičiau, nei manytum, kai tik paslauga pradeda veikti nenutrūkstamai. Kalbant apie aplinką, Python ir JavaScript turi geriausius įrankius, tačiau kadangi API naudoja HTTP protokolą, tiks bet kuri kalba, galinti siųsti užklausas.
Pradinis nustatymas
Pirmas žingsnis – saugiai išsaugoti API raktą aplinkos kintamajame:
export XAI_API_KEY="xai-your-key-here"
Niekada neįtrauk rakto tiesiai į savo šaltinio kodą. Priežastis banali: faile įrašytas raktas anksčiau ar vėliau atsidurs „Git“ saugykloje, o į viešą saugyklą įkeltas raktas bus panaudotas per kelias minutes botų, nuskaunančių pakeitimus, tuo tarpu sąskaita bus išrašyta tavo vardu.
Kitas žingsnis – SDK pasirinkimas. Natūralus xAI SDK Python kalbai įdiegiamas komanda pip install xai-sdk. Jei tavo kodas jau kviečia „OpenAI“, openai biblioteka veiks iškart dėl formato suderinamumo. JavaScript pusėje pridėk Vercel AI SDK komanda npm install ai @ai-sdk/xai, ir jis integruosis su „React“ bei „Next.js“ programomis.
Tavo pirmoji užklausa
Naudojant vietinį SDK, kliento sukūrimas ir pokalbio pradžia užtrunka tris eilutes:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")
Maršrutas, suderinamas su „OpenAI“, yra toks pat tiesus: lyginant su esamu kodu, keičiasi tik base_url, todėl daugelis komandų pereina prie jo per kelias minutes.
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."
)
Norint patikrinti, ar raktas veikia dar prieš rašant kodą, niekas neprilygsta komandinės eilutės iškvietimui:
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?"
}'
Ką atskleidžia API
Pagrindas yra teksto generavimas (pokalbių atsakymai, rašymas, analizė), kartu su samprotavimo režimu, kuris žingsnis po žingsnio sprendžia sudėtingas problemas. Srautinis perdavimas (streaming) tai papildo, pateikdamas atsakymą žetonas po žetono, užuot laukęs, kol generavimas baigsis.
Antra grupė suteikia prieigą prie informacijos: realaus laiko paieška internete ir „X“ platformoje bei RAG, kuris užklausa tavo sukurtas dokumentų kolekcijas. Multimodalioji pusė apima tavo pateiktų vaizdų supratimą, vaizdų ir vaizdo įrašų generavimą naudojant grok-imagine, bei balsą – pokalbius žodžiu ir TTS (teksto pavertimą kalba).
Galiausiai, trys mechanizmai daro API programuojamą griežtąja prasme: funkcijų kvietimas, leidžiantis modeliui kviesti tavo pačio funkcijas; struktūrizuota išvestis, garantuojanti tinkamą JSON be trapaus papildomo apdorojimo; ir kodo vykdymas serverio pusėje.
Pasirink savo modelį
Samprotavimo gebėjimai skiriasi priklausomai nuo modelio. grok-4.7, flagmanas, siūlo konfigūruojamą samprotavimą: parametras reasoning_effort (low, medium, high arba xhigh) nustato, kiek giliai jis mąsto kiekvienoje užklausoje. grok-4.3 išlieka biudžetiniu, labai ilgo konteksto pasirinkimu, kainuojančiu maždaug perpus mažiau. Egzistuoja ir nesamprotuojančios modelių versijos paprastiems uždaviniams: persakymui ar klasifikavimui vidinio svarstymo nereikia.
Pavadinimų konvencijos daro įtaką tavo programos stabilumui:
grok-4.20: naujausia rekomenduojama stabili versijagrok-4.20-latest: naujausia versija (gali keistis)grok-4.20-0309: versija, pritvirtinta prie konkrečios datos (kovo 9 d.)
Gamybinėje aplinkoje pritvirtinta versija apsaugo tavo prompts nuo nematomų modelio pakeitimų; latest tinka tyrinėjimams, jei sutinki, kad elgsena gali pasikeisti.
Apkrovos ribos ir geriausios praktikos
API taiko apkrovos ribas, kad išlaikytų paslaugos stabilumą: pradiniame lygmenyje – apie 10 milijonų žetonų per minutę ir 1 800 užklausų per minutę tokiems modeliams kaip grok-4.3, o kylant lygiui – dar daugiau. Vaizdų ir vaizdo įrašų generavimo modeliai turi savo, daug mažesnes ribas – nuo 30 iki 300 užklausų per minutę priklausomai nuo modelio, todėl vartotojams skirtose paslaugose jas reikia stebėti atidžiai.
Keletas įpročių atskiria prototipą nuo patikimos integracijos. Įjunk srautinį perdavimą ilgiems atsakymams, nes trisdešimt sekundžių žiūrėti į tuščią ekraną atrodo kaip gedimas. Perduok pokalbio ID, kad galėtum pasinaudoti talpyklos (caching) privalumais. Nukreipk kiekvieną užduotį į tinkamą modelį: grok-4.3 paprastiems dideliems kiekiams, grok-4.20 – samprotavimams. Tvarkyk klaidas naudodamas pakartotinius bandymus ir eksponentinį delsos didinimą (exponential backoff), kitaip eismo šuolis virs atmestų užklausų lavina. Ir stebėk savo naudojimą konsolėje, kad mėnesio pabaigoje netektų nustebti pamatius galutinę sumą.
Svarbiausi punktai
- xAI API yra suderinamas su „OpenAI“ formatu, todėl migracija yra lengva
- Yra keli prieinami SDK: vietinis xAI, „OpenAI“ ir Vercel AI SDK
- API apima tekstą, vaizdus, vaizdo įrašus, balsą ir paiešką
- Du modelių lygmenys: grok-4.7 (flagmanas, konfigūruojamas samprotavimas) ir grok-4.3 (biudžetinis, 1 mln. kontekstas)
- Visada saugok API raktą aplinkos kintamajame, niekada neįtrauk jo tiesiai į kodą