Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

xAI API un saderība ar OpenAI

Nodarbība 4 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Pazīstama API
  2. Minimāla konfigurācija
  3. API atslēgas iegūšana
  4. Pieejamie galapunkti
  5. Saderības ierobežojumi
  6. Galvenās atziņas

Pazīstama API

xAI API izmanto to pašu formātu kā OpenAI API. Ja esi iepriekš strādājis ar OpenAI API vai saderīgiem rīkiem, tev nav jāapgūst nekas jauns. Mainās tikai bāzes URL.

https://api.x.ai/v1

Šī saderība ir xAI stratēģiska izvēle. Tā vietā, lai uzspiestu jaunu proprietāru formātu, viņi pieņēma de facto nozares standartu. Tādējādi jebkurš rīks, SDK vai redaktors, kas atbalsta OpenAI API, var nekavējoties izmantot grok-build-0.1.

Minimāla konfigurācija

Lai jebkurā saderīgā klientā pārietu no OpenAI uz xAI, tev jāmaina tikai divi parametri:

  1. Bāzes URL: nomaini https://api.openai.com/v1 pret https://api.x.ai/v1
  2. API atslēga: izmanto savu xAI API atslēgu (iegūta vietnē console.x.ai)

Viss pārējais — ziņojumu formāts, temperatūras parametri, atbildes struktūra — ir identisks.

Piemērs ar OpenAI Python SDK

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."}
    ]
)

Tu izmanto standarta OpenAI SDK bez jebkādām izmaiņām. Mainās tikai base_url un modeļa nosaukums.

Piemērs ar 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"}
    ]
  }'

API atslēgas iegūšana

  1. Dodies uz console.x.ai
  2. Pieraksties savā xAI kontā (vai izveido to vietnē accounts.x.ai)
  3. Sadaļā „API Keys” ģenerē jaunu atslēgu
  4. Nekavējoties to nokopē — tā vairs netiks parādīta

Glabā šo atslēgu drošībā. Nekad neievieto to Git repozitorijā un nekopīgo komandas tērzētavā. Izmanto vides mainīgo vai noslēpumu pārvaldnieku.

Pieejamie galapunkti

grok-build-0.1 atbalsta šādus galapunktus, visi OpenAI formātā:

  • /v1/chat/completions: teksta un koda ģenerēšana (visbiežāk izmantotais)
  • /v1/chat/completions ar stream: true: straumēšana ar reasoning_content
  • /v1/chat/completions ar tools: iebūvēta rīku izsaukšana

Saderības ierobežojumi

Pastāv dažas nelielas atšķirības:

  • Pieejamie modeļi ir xAI (grok-build-0.1, grok-4.5 u.c.), nevis OpenAI
  • Daži OpenAI specifiskie parametri (piemēram, logprobs) var netikt atbalstīti
  • reasoning_content ir specifisks xAI API un nepastāv OpenAI API

Galvenās atziņas

  • xAI API atrodas adresē https://api.x.ai/v1 un ir saderīgs ar OpenAI formātu
  • Migrācijai tev jāmaina tikai bāzes URL un API atslēga
  • OpenAI Python SDK darbojas tāds, kāds ir
  • API atslēgu iegūsti vietnē console.x.ai
  • Visi redaktori, kas saderīgi ar OpenAI, darbojas ar xAI