SDK-ul OpenAI pentru Grok
Pe această pagină
Actualizat la 3 noiembrie 2026, pe baza paginii Models de la xAI: grok-4.7 (septembrie 2026) a succedat lui grok-4.5 ca model recomandat; exemplul, scris inițial pentru grok-4.5, funcționează și cu grok-4.7. Surse: Models · Release notes.
Clarificat la 3 noiembrie 2026, conform referinței Chat Completions de la xAI: apelul nu este strict identic cu cel de la OpenAI; parametrii
logprobsșitop_logprobs(ignorați începând cugrok-4.20) șilogit_bias(nesuportat) se adaugă diferențelor enumerate mai jos. Sursă: xAI, Chat Completions.
Refolosiți ceea ce știți despre OpenAI
Dacă lucrați deja cu SDK-ul OpenAI în Python, îl puteți utiliza ca atare pentru a apela API-ul Grok. Trebuie doar să redirecționați cererile către serverele xAI modificând URL-ul de bază. Aceasta este cea mai rapidă abordare dacă dispuneți deja de cod existent.
Instalare
Dacă SDK-ul OpenAI nu este încă instalat în proiectul dumneavoastră:
pip install openai
Configurarea clientului pentru xAI
Singura diferență față de utilizarea standard OpenAI este parametrul base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Asta este tot. De acum înainte, fiecare metodă din SDK-ul OpenAI funcționează cu modelele Grok.
Trimiterea unui mesaj
Apelul are aceeași structură ca pentru GPT, cu excepția parametrilor nesuportați (vezi mai jos):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Modele disponibile
Înlocuiți pur și simplu numele modelului OpenAI cu un model Grok:
grok-4.7: modelul recomandat de xAI, versatil, cu suport pentru input imagine (grok-4.6șigrok-4.5rămân disponibile)grok-4.20-0309-reasoning: raționament avansatgrok-4.3: răspunsuri rapide și ieftine (context de 1M)
Migrarea unui proiect OpenAI existent
Pentru a adapta un proiect existent, aveți două opțiuni.
Opțiunea 1: Variabile de mediu
Modificați variabilele fără a atinge codul:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
SDK-ul OpenAI citește automat aceste variabile. Codul dumneavoastră existent va funcționa dacă schimbați și numele modelului și eliminați parametrii pe care xAI nu îi suportă.
Opțiunea 2: Configurare explicită
Scrieți o funcție de inițializare care comută între furnizori:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI implicit
client = create_client("xai")
Această abordare vă permite să comutați ușor între furnizori în timpul migrării.
Diferențe de reținut
Deși API-ul este compatibil, unele comportamente diferă:
- Parametrii
frequency_penaltyșipresence_penaltynu sunt suportați pe modelele de raționament - Parametrul
stopnu este disponibil pe modelele de raționament logprobsșitop_logprobssunt ignorate silențios de modelelegrok-4.20și mai noi, iarlogit_biasnu este suportat- Numele modelelor sunt, evident, diferite
- Unele funcționalități xAI (căutare X, căutare web) nu sunt disponibile prin formatul standard OpenAI
Când să alegeți această abordare
Modul de compatibilitate are cel mai mult sens atunci când codul dumneavoastră existent contează mai mult decât funcționalitățile exclusive. Cel mai frecvent caz este migrarea: codul deja scris pentru OpenAI trece la Grok prin schimbarea URL-ului de bază și a cheii: două linii, nicio rescriere. Reversibilitatea contează, de asemenea: atâta timp cât rămâneți la formatul OpenAI, schimbarea furnizorului rămâne o problemă de configurare, ceea ce este valoros pentru compararea modelelor sau negociere. Apoi, există ecosistemul: instrumentele terțe construite în jurul SDK-ului OpenAI, cum ar fi LangChain și LlamaIndex, funcționează imediat, iar o echipă care cunoaște deja SDK-ul nu are nimic nou de învățat. Prețul de plătit este cel menționat mai sus: funcționalitățile specifice xAI trec pe plan secund.
Puncte cheie
- Adăugați
base_url="https://api.x.ai/v1"în constructorulOpenAI() - Înlocuiți cheia API și numele modelului
- Variabilele
OPENAI_BASE_URLșiOPENAI_API_KEYpermit o migrare fără a modifica codul - Anumiți parametri (penalizări, stop) nu sunt suportați pe modelele de raționament