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

SDK OpenAI cu base_url xAI

Lecția 5 din 12 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Utilizarea SDK-ului OpenAI pentru accesarea Grok
  2. Configurare
  3. Apeluri identice cu OpenAI
  4. Streaming cu SDK-ul OpenAI
  5. JavaScript / TypeScript
  6. Comutarea între furnizori
  7. Ce nu se transferă între furnizori
  8. Puncte cheie

Actualizat la 3 noiembrie 2026. Conform referinței Chat Completions de la xAI, compatibilitatea cu SDK-ul OpenAI nu este „100%“ — mai mulți parametri nu sunt susținuți de modelele de raționament, sunt ignorați de modelele recente sau nu sunt susținuți de niciun model. Sursă: xAI, Chat Completions.

Utilizarea SDK-ului OpenAI pentru accesarea Grok

Unul dintre principalele avantaje ale endpoint-ului Chat Completions de la xAI este compatibilitatea sa cu SDK-ul OpenAI. Puteți utiliza pachetul openai pe care îl cunoașteți deja, modificând simplu base_url pentru a indica spre serverele xAI.

Această abordare este ideală dacă migrați o aplicație existentă de la OpenAI la Grok sau dacă doriți să comutați între furnizori cu modificări minime.

Configurare

Instalarea este aceeași ca pentru orice proiect care utilizează SDK-ul OpenAI:

pip install openai

Singura diferență constă în crearea clientului, unde specificați URL-ul de bază și cheia API xAI:

from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

Cei doi parametri esențiali sunt:

  • api_key: Cheia dvs. API xAI (nu o cheie OpenAI)
  • base_url: https://api.x.ai/v1 — aceasta redirecționează cererile către xAI în loc de OpenAI

Apeluri identice cu OpenAI

Odată configurat clientul, utilizarea este aceeași ca în cazul SDK-ului standard OpenAI — cu excepția parametrilor pe care xAI nu îi susține, detaliați mai jos:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a technical assistant."},
        {"role": "user", "content": "What is the difference between TCP and UDP?"}
    ],
    temperature=0.7,
    max_tokens=1000
)

print(response.choices[0].message.content)

Singura diferență vizibilă este numele modelului: grok-4.20-0309-reasoning în loc de gpt-5.6, de exemplu.

Streaming cu SDK-ul OpenAI

Streaming-ul funcționează exact în același mod:

stream = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "user", "content": "Explain the concept of microservices."}
    ],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

JavaScript / TypeScript

SDK-ul OpenAI pentru Node.js funcționează în același mod:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: "https://api.x.ai/v1",
});

const response = await client.chat.completions.create({
  model: "grok-4.20-0309-reasoning",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "Hello, how are you?" },
  ],
});

console.log(response.choices[0].message.content);

Rețineți că proprietatea este baseURL (U majuscul) în JavaScript, în timp ce în Python este base_url.

Comutarea între furnizori

Principalul beneficiu al acestei abordări este capacitatea de a schimba furnizorul printr-o singură variabilă:

import os
from openai import OpenAI

provider = os.getenv("LLM_PROVIDER", "xai")

configs = {
    "xai": {
        "api_key": os.getenv("XAI_API_KEY"),
        "base_url": "https://api.x.ai/v1",
        "model": "grok-4.20-0309-reasoning"
    },
    "openai": {
        "api_key": os.getenv("OPENAI_API_KEY"),
        "base_url": "https://api.openai.com/v1",
        "model": "gpt-5.6"
    }
}

config = configs[provider]
client = OpenAI(api_key=config["api_key"], base_url=config["base_url"])

Această arhitectură multi-furnizor este comună în aplicațiile de producție care doresc să mențină flexibilitatea.

Ce nu se transferă între furnizori

Compatibil nu înseamnă identic. Referința endpoint-ului xAI semnalează mai mulți parametri pe care modelele de raționament nu îi susțin — frequency_penalty, presence_penalty (la fel ca grok-3) și stop. logprobs și top_logprobs sunt ignorate fără eroare de către modelele grok-4.20 și mai noi, iar logit_bias nu este susținut. Codul care setează acești parametri pentru OpenAI va trebui să îi elimine pentru Grok. Câmpurile ignorate silențios sunt cele mai insidioase, deoarece nimic nu semnalează că nu au niciun efect. Instrumentele găzduite diferă, de asemenea, între furnizori: căutarea web de la OpenAI nu este aceeași cu cea de la xAI. În final, xAI clasifică acum Chat Completions ca un endpoint legacy și recomandă API-ul Responses (lecțiile 11 și 12).

Puncte cheie

  • SDK-ul OpenAI funcționează cu xAI prin simpla modificare a base_url în https://api.x.ai/v1
  • Metodele și formatele de răspuns sunt aceleași, dar unii parametri nu sunt susținuți (frequency_penalty, presence_penalty, stop pe modelele de raționament, logit_bias) sau sunt ignorați (logprobs începând cu grok-4.20)
  • Adaptați cheia API, numele modelului și parametrii nesuportați
  • Această abordare simplifică migrarea de la OpenAI și permite comutarea între furnizori
  • Streaming-ul și tipizarea SDK-ului OpenAI funcționează; instrumentele găzduite sunt specifice fiecărui furnizor