API xAI și compatibilitatea cu OpenAI
Pe această pagină
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:
- URL de bază: înlocuiți
https://api.openai.com/v1cuhttps://api.x.ai/v1 - 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
- Accesați console.x.ai
- Conectați-vă cu contul dvs. xAI (sau creați unul la accounts.x.ai)
- În secțiunea API Keys, generați o cheie nouă
- 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/completionscustream: true: streaming cureasoning_content/v1/chat/completionscutools: 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_contenteste 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