URL-ul de bază al API-ului
Pe această pagină
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/v1cuhttps://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 imaginiPOST /v1/images/edits: editare de imagini existentePOST /v1/videos/generations: generare de videoclipuriPOST /v1/tts: sinteză vocală (text-to-speech)
Gestionarea fișierelor
POST /v1/files: încărcarea unui fișierGET /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/v1pentru 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/completionsrămâne disponibil pentru compatibilitate