API xAI in združljivost z OpenAI
Na tej strani
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:
- Osnovni URL: zamenjaj
https://api.openai.com/v1zhttps://api.x.ai/v1 - 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
- Obišči console.x.ai
- Prijavi se s svojim računom xAI (ali ga ustvari na accounts.x.ai)
- V razdelku API Keys generiraj nov ključ
- 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/completionszstream: true: pretakanje zreasoning_content/v1/chat/completionsztools: 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_contentje specifičen za API xAI in v API-ju OpenAI ne obstaja
Ključne ugotovitve
- API xAI se nahaja na
https://api.x.ai/v1in 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