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

SDK-ul OpenAI pentru Grok

Lecția 6 din 14 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Refolosiți ceea ce știți despre OpenAI
  2. Instalare
  3. Configurarea clientului pentru xAI
  4. Trimiterea unui mesaj
  5. Migrarea unui proiect OpenAI existent
  6. Diferențe de reținut
  7. Când să alegeți această abordare
  8. Puncte cheie

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 și top_logprobs (ignorați începând cu grok-4.20) și logit_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 și grok-4.5 rămân disponibile)
  • grok-4.20-0309-reasoning: raționament avansat
  • grok-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 și presence_penalty nu sunt suportați pe modelele de raționament
  • Parametrul stop nu este disponibil pe modelele de raționament
  • logprobs și top_logprobs sunt ignorate silențios de modelele grok-4.20 și mai noi, iar logit_bias nu 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 constructorul OpenAI()
  • Înlocuiți cheia API și numele modelului
  • Variabilele OPENAI_BASE_URL și OPENAI_API_KEY permit o migrare fără a modifica codul
  • Anumiți parametri (penalizări, stop) nu sunt suportați pe modelele de raționament