xAI API un saderība ar OpenAI
Šajā lapā
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:
- Bāzes URL: nomaini
https://api.openai.com/v1prethttps://api.x.ai/v1 - 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
- Dodies uz console.x.ai
- Pieraksties savā xAI kontā (vai izveido to vietnē accounts.x.ai)
- Sadaļā „API Keys” ģenerē jaunu atslēgu
- 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/completionsarstream: true: straumēšana arreasoning_content/v1/chat/completionsartools: 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_contentir specifisks xAI API un nepastāv OpenAI API
Galvenās atziņas
- xAI API atrodas adresē
https://api.x.ai/v1un 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