Salt la conținutul principal
Română— Alege o limbă
Meniu

API-ul xAI pentru dezvoltatori

Lecția 15 din 16 Actualizată 29 iulie 2026 Începător
Pe această pagină
  1. Integrarea Grok în aplicațiile dumneavoastră
  2. Condiții prealabile
  3. Configurarea inițială
  4. Prima dumneavoastră cerere
  5. Ce expune API-ul
  6. Alegerea modelului
  7. Limite de rată și bune practici
  8. Puncte cheie

Integrarea Grok în aplicațiile dumneavoastră

Tot ce ați învățat să faceți în interfața Grok poate fi declanșat direct din propriul cod. API-ul xAI aduce aceste capacități în aplicațiile, site-urile web și serviciile dumneavoastră: conversația încetează să mai fie un loc unde mergeți și devine o funcție pe care produsul dumneavoastră o apelează.

Condiții prealabile

Aveți nevoie de patru elemente înainte de a scrie prima linie de cod:

  1. Un cont xAI creat la accounts.x.ai
  2. O cheie API generată pe console.x.ai
  3. O metodă de plată configurată (pentru a depăși cota gratuită)
  4. Un mediu de dezvoltare Python sau JavaScript

Primele două sunt lucruri pe care le-ați făcut deja în acest curs: contul gestionează autentificarea, iar cheia vă identifică aplicația în fața API-ului. Metoda de plată intervine doar atunci când utilizarea depășește cota gratuită, lucru care se întâmplă mai repede decât credeți imediat ce un serviciu rulează continuu. În ceea ce privește mediul, Python și JavaScript oferă cele mai bune instrumente, dar deoarece API-ul comunică prin HTTP, orice limbaj capabil să trimită o cerere este suficient.

Configurarea inițială

Primul pas este stocarea în siguranță a cheii API într-o variabilă de mediu:

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

Nu introduceți niciodată cheia direct în codul sursă. Motivul este banal: o cheie scrisă într-un fișier ajunge mai devreme sau mai târziu într-un depozit Git, iar o cheie împinsă într-un depozit public este exploatată în câteva minute de boți care scanează commit-urile, în timp ce factura rămâne pe numele dumneavoastră.

Urmează alegerea unui SDK. SDK-ul nativ xAI pentru Python se instalează cu pip install xai-sdk. Dacă codul dumneavoastră apelează deja OpenAI, biblioteca openai funcționează ca atare, datorită compatibilității formatului. În partea de JavaScript, adăugați Vercel AI SDK cu npm install ai @ai-sdk/xai, iar acesta se integrează cu aplicațiile React și Next.js.

Prima dumneavoastră cerere

Cu SDK-ul nativ, crearea clientului și deschiderea unei conversații necesită trei linii:

from xai_sdk import Client
import os

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

Abordarea compatibilă cu OpenAI este la fel de directă: doar base_url se schimbă față de codul existent, motiv pentru care multe echipe fac tranziția în câteva minute.

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

Pentru a verifica dacă o cheie funcționează înainte chiar de a scrie orice cod, nimic nu bate o apelare din linia de comandă:

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

Ce expune API-ul

Fundația este generarea de text (răspunsuri conversaționale, scriere, analiză), alături de un mod de raționament care rezolvă probleme complexe pas cu pas. Streaming-ul completează acest lucru prin livrarea răspunsului token cu token, în loc să aștepte finalizarea generării.

Un al doilea set oferă acces la informații: căutare web și în X în timp real, și RAG, care interoghează colecții de documente pe care le-ați construit. Partea multimodală acoperă înțelegerea imaginilor pe care le furnizați, generarea de imagini și videoclipuri cu grok-imagine, și vocea, cu conversații vorbite și TTS (text-to-speech).

În final, trei mecanisme fac API-ul programabil în sens strict: apelarea de funcții (function calling), care permite modelului să apeleze propriile dumneavoastră funcții; ieșiri structurate, care garantează un JSON utilizabil fără post-procesare fragilă; și executarea codului lato-server.

Alegerea modelului

Raționamentul variază în funcție de model. grok-4.7, modelul principal, oferă raționament configurabil: parametrul reasoning_effort (low, medium, high sau xhigh) stabilește cât de profund gândește, cerere cu cerere. grok-4.3 rămâne opțiunea bugetară, cu context foarte lung, la aproximativ jumătate din preț. Există versiuni ale modelelor fără raționament pentru sarcini simple: reformularea sau clasificarea nu necesită deliberare internă.

Convențiile de denumire afectează stabilitatea aplicației dumneavoastră:

  • grok-4.20: cea mai recentă versiune stabilă recomandată
  • grok-4.20-latest: cea mai recentă versiune (se poate schimba)
  • grok-4.20-0309: o versiune fixată la o dată specifică (9 martie)

În producție, o versiune fixată vă protejează prompturile de modificări silențioase ale modelului; latest este acceptabil pentru explorare, atâta timp cât acceptați că comportamentul se poate schimba.

Limite de rată și bune practici

API-ul impune limite de rată pentru a menține stabilitatea serviciului: la nivelul de intrare, aproximativ 10 milioane de tokeni pe minut și 1.800 de cereri pe minut pentru modele precum grok-4.3, și mai mult pe măsură ce nivelul dumneavoastră crește. Modelele de generare de imagini și videoclipuri au propriile limite, mult mai scăzute, de la 30 la 300 de cereri pe minut în funcție de model, așa că țineți-le sub observație pentru un serviciu orientat către consumatori.

Câteva obiceiuri fac diferența dintre un prototip și o integrare solidă. Activați streaming-ul pentru răspunsuri lungi, deoarece treizeci de secunde în fața unui ecran gol par o pană de sistem. Transmiteți un ID de conversație pentru a beneficia de caching. Dirijați fiecare sarcină către modelul potrivit: grok-4.3 pentru volume simple, grok-4.20 pentru raționament. Gestionați erorile cu reîncercări și backoff exponențial, sau un vârf de trafic se transformă într-o avalanșă de cereri respinse. Și monitorizați utilizarea în consolă înainte de a descoperi totalul la sfârșitul lunii.

Puncte cheie

  • API-ul xAI este compatibil cu formatul OpenAI, ceea ce facilitează migrarea
  • Sunt disponibile mai multe SDK-uri: xAI nativ, OpenAI și Vercel AI SDK
  • API-ul acoperă text, imagini, video, voce și căutare
  • Două niveluri de modele: grok-4.7 (principal, raționament configurabil) și grok-4.3 (buget, context 1M)
  • Stocați întotdeauna cheia API într-o variabilă de mediu, niciodată hard-codată