Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

API xAI in združljivost z OpenAI

Lekcija 4 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Znan API
  2. Minimalna konfiguracija
  3. Pridobitev ključa API
  4. Razpoložljive končne točke
  5. Omejitve združljivosti
  6. Ključne ugotovitve

Znan API

API xAI uporablja enak format kot API OpenAI. Če si že delal z API-jem OpenAI ali združljivimi orodji, se ti ni treba učiti ničesar novega. Edina sprememba je osnovni URL.

https://api.x.ai/v1

Ta združljivost je strateška odločitev podjetja xAI. Namesto da bi vsilili novo lastniško obliko, so sprejeli dejanski industrijski standard. Posledično lahko vsako orodje, SDK ali urejevalnik, ki podpira API OpenAI, takoj uporabi grok-build-0.1.

Minimalna konfiguracija

Če želiš v katerem koli združljivem odjemalcu preklopiti z OpenAI na xAI, moraš spremeniti le dva parametra:

  1. Osnovni URL: zamenjaj https://api.openai.com/v1 z https://api.x.ai/v1
  2. Ključ API: uporabi svoj ključ API za xAI (pridobljen na console.x.ai)

Vse ostalo – oblika sporočil, parametri temperature, struktura odgovora – je identično.

Primer s Python SDK za OpenAI

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

Standardni SDK za OpenAI uporabljaš brez kakršnih koli sprememb. Spremenita se le base_url in ime modela.

Primer z 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"}
    ]
  }'

Pridobitev ključa API

  1. Obišči console.x.ai
  2. Prijavi se s svojim računom xAI (ali ga ustvari na accounts.x.ai)
  3. V razdelku API Keys generiraj nov ključ
  4. Ključ takoj kopiraj – ponovno ne bo prikazan

Ta ključ hrani varno. Nikoli ga ne potisni v skladišče Git ali deli v ekipnem klepetu. Uporabi spremenljivko okolja ali upravitelja skrivnosti.

Razpoložljive končne točke

grok-build-0.1 podpira naslednje končne točke, vse v formatu OpenAI:

  • /v1/chat/completions: generiranje besedila in kode (najpogosteje uporabljeno)
  • /v1/chat/completions z stream: true: pretakanje z reasoning_content
  • /v1/chat/completions z tools: izvorni klic orodij

Omejitve združljivosti

Obstaja nekaj manjših razlik:

  • Razpoložljivi modeli so xAI-jevi (grok-build-0.1, grok-4.5 itd.), ne OpenAI-jevi
  • Nekateri parametri, specifični za OpenAI (kot je logprobs, morda niso podprti
  • reasoning_content je specifičen za API xAI in v API-ju OpenAI ne obstaja

Ključne ugotovitve

  • API xAI se nahaja na https://api.x.ai/v1 in je združljiv s formatom OpenAI
  • Za selitev moraš spremeniti le osnovni URL in ključ API
  • Python SDK za OpenAI deluje brez sprememb
  • Ključ API pridobiš na console.x.ai
  • Vsi urejevalniki, združljivi z OpenAI, delujejo z xAI