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

URL-ul de bază al API-ului

Lecția 4 din 14 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Punctul de intrare în API-ul Grok
  2. URL-ul de bază
  3. Compatibilitatea cu ecosistemul OpenAI
  4. Endpoint-urile principale
  5. Setarea URL-ului în SDK-urile dvs.
  6. Testarea conectivității
  7. Limite și cote
  8. Puncte cheie

Punctul de intrare în API-ul Grok

Fiecare solicitare către API-ul xAI trece printr-un singur URL de bază. Înțelegerea acestui URL și a endpoint-urilor disponibile este esențială înainte de a scrie prima linie de cod.

URL-ul de bază

API-ul Grok se află la această adresă:

https://api.x.ai/v1

Acest URL reprezintă rădăcina pentru fiecare endpoint. De exemplu, pentru a genera un răspuns, URL-ul complet este https://api.x.ai/v1/responses.

De ce /v1?

Prefixul /v1 indică versiunea API-ului. Versiunarea permite xAI să evolueze API-ul fără a afecta aplicațiile existente. Dacă va apărea o versiune 2, aceasta va coexista cu v1 pe o perioadă de tranziție.

Compatibilitatea cu ecosistemul OpenAI

O caracteristică fundamentală a API-ului xAI este compatibilitatea sa cu formatul OpenAI. În practică, dacă aveți deja cod care funcționează cu API-ul OpenAI, trebuie doar să modificați două setări pentru a utiliza Grok:

  • URL-ul de bază: înlocuiți https://api.openai.com/v1 cu https://api.x.ai/v1
  • Cheia API: înlocuiți cheia dvs. OpenAI cu cheia dvs. xAI

Această compatibilitate se extinde la majoritatea instrumentelor și bibliotecilor din ecosistemul OpenAI: LangChain, LlamaIndex, LiteLLM și multe altele funcționează cu Grok fără modificări de cod.

Endpoint-urile principale

API-ul expune mai multe endpoint-uri grupate după funcționalitate.

Generare de text

  • POST /v1/responses: endpoint-ul principal pentru generarea răspunsurilor (format modern)
  • POST /v1/chat/completions: endpoint-ul compatibil cu OpenAI (format legacy, încă suportat)

Generare de media

  • POST /v1/images/generations: generare de imagini
  • POST /v1/images/edits: editare de imagini existente
  • POST /v1/videos/generations: generare de videoclipuri
  • POST /v1/tts: sinteză vocală (text-to-speech)

Gestionarea fișierelor

  • POST /v1/files: încărcarea unui fișier
  • GET /v1/files: listarea fișierelor încărcate

Timp real

  • wss://api.x.ai/v1/realtime: agent vocal prin WebSocket

Setarea URL-ului în SDK-urile dvs.

Când utilizați un SDK compatibil cu OpenAI, trebuie să specificați explicit URL-ul de bază:

from openai import OpenAI

client = OpenAI(
    api_key="xai-your-key",
    base_url="https://api.x.ai/v1"
)

Cu SDK-ul nativ xAI, URL-ul este preconfigurat și nu trebuie să setați nimic.

Testarea conectivității

Înainte de a scrie orice cod, un apel direct validează întregul lanț (URL, cheie, rețea):

curl https://api.x.ai/v1/models \
  -H "Authorization: Bearer xai-your-key"

Răspunsul listează modelele disponibile cu cheia dvs. Aceasta este, de asemenea, cea mai fiabilă metodă de a afla ID-urile exacte ale modelelor disponibile în contul dvs., fără a depinde de documentație care se poate modifica. Păstrați acest obicei: validați fiecare mediu nou (mașină, CI, server) cu acest același apel înainte de orice implementare.

Limite și cote

API-ul impune limite de rată (rate limits) pentru fiecare echipă și fiecare model. Dacă le depășiți, veți primi o eroare HTTP 429. Consola xAI afișează cotele curente și utilizarea dvs. în timp real.

Puncte cheie

  • URL-ul de bază este https://api.x.ai/v1 pentru fiecare endpoint
  • API-ul este compatibil cu formatul OpenAI: schimbați URL-ul și cheia, și atât
  • Endpoint-ul principal de generare este POST /v1/responses
  • Endpoint-ul legacy POST /v1/chat/completions rămâne disponibil pentru compatibilitate