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

API xAI și compatibilitatea cu OpenAI

Lecția 4 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Un API familiar
  2. Configurare minimă
  3. Obținerea unei chei API
  4. Endpoint-uri disponibile
  5. Limitări de compatibilitate
  6. Puncte cheie

Un API familiar

API-ul xAI utilizează același format ca și API-ul OpenAI. Dacă ați lucrat anterior cu API-ul OpenAI sau cu instrumente compatibile, nu aveți nimic nou de învățat. Singurul element care se modifică este URL-ul de bază.

https://api.x.ai/v1

Această compatibilitate reprezintă o alegere strategică din partea xAI. În loc să impună un nou format proprietar, ei au adoptat standardul de facto al industriei. Drept urmare, orice instrument, SDK sau editor care suportă API-ul OpenAI poate utiliza imediat grok-build-0.1.

Configurare minimă

Pentru a trece de la OpenAI la xAI în orice client compatibil, trebuie să modificați doar doi parametri:

  1. URL de bază: înlocuiți https://api.openai.com/v1 cu https://api.x.ai/v1
  2. Cheie API: utilizați cheia dvs. API xAI (obținută de la console.x.ai)

Tot restul — formatul mesajelor, parametrii de temperatură, structura răspunsului — este identic.

Exemplu cu SDK-ul Python pentru OpenAI

from openai import OpenAI

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

response = client.chat.completions.create(
    model="grok-build-0.1",
    messages=[
        {"role": "system", "content": "You are a programming assistant."},
        {"role": "user", "content": "Write a quicksort function in Python."}
    ]
)

Utilizați SDK-ul standard OpenAI fără nicio modificare. Doar base_url și numele modelului se schimbă.

Exemplu cu curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer your-xai-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-build-0.1",
    "messages": [
      {"role": "user", "content": "Explain the difference between let and const in JavaScript"}
    ]
  }'

Obținerea unei chei API

  1. Accesați console.x.ai
  2. Conectați-vă cu contul dvs. xAI (sau creați unul la accounts.x.ai)
  3. În secțiunea API Keys, generați o cheie nouă
  4. Copiați-o imediat — nu va mai fi afișată din nou

Păstrați această cheie în siguranță. Nu o includeți niciodată într-un depozit Git și nu o partajați în chat-ul echipei. Utilizați o variabilă de mediu sau un manager de secrete.

Endpoint-uri disponibile

grok-build-0.1 suportă următoarele endpoint-uri, toate în format OpenAI:

  • /v1/chat/completions: generare de text și cod (cel mai utilizat)
  • /v1/chat/completions cu stream: true: streaming cu reasoning_content
  • /v1/chat/completions cu tools: apelare nativă de instrumente

Limitări de compatibilitate

Există câteva diferențe minore:

  • Modelele disponibile sunt cele ale xAI (grok-build-0.1, grok-4.5 etc.), nu cele ale OpenAI
  • Anumiți parametri specifici OpenAI (cum ar fi logprobs) pot să nu fie suportați
  • reasoning_content este specific API-ului xAI și nu există în API-ul OpenAI

Puncte cheie

  • API-ul xAI se află la https://api.x.ai/v1 și este compatibil cu formatul OpenAI
  • Trebuie doar să schimbați URL-ul de bază și cheia API pentru a migra
  • SDK-ul Python pentru OpenAI funcționează ca atare
  • Obțineți cheia API la console.x.ai
  • Toate editoarele compatibile cu OpenAI funcționează cu xAI