xAI API ja OpenAI ühilduvus
Sellel lehel
Tuttav API
xAI API kasutab sama vormingut kui OpenAI API. Kui oled varem töötanud OpenAI API või sellega ühilduvate tööriistadega, pole sul midagi uut õppida. Ainus, mis muutub, on baas-URL.
https://api.x.ai/v1
See ühilduvus on xAI strateegiline valik. Uue omanikulise vormingu pealesurumise asemel võtsid nad kasutusele de facto tööstusstandardi. Seetõttu saab iga tööriist, SDK või redaktor, mis toetab OpenAI API-d, kohe kasutada mudelit grok-build-0.1.
Minimaalne konfiguratsioon
Et lülituda OpenAI-lt xAI-le mis tahes ühilduvas kliendis, pead muutma vaid kahte parameetrit:
- Baas-URL: asenda
https://api.openai.com/v1aadressigahttps://api.x.ai/v1 - API võti: kasuta oma xAI API võtit (saadud aadressilt
console.x.ai)
Kõik muu – sõnumite vorming, temperatuuri parameetrid, vastuse struktuur – on identne.
Näide OpenAI Python SDK-ga
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."}
]
)
Kasutad standardset OpenAI SDK-d ilma igasuguste muudatusteta. Muutuvad vaid base_url ja mudeli nimi.
Näide curl-iga
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 võtme hankimine
- Mine aadressile console.x.ai
- Logi sisse oma xAI kontoga (või loo konto aadressil accounts.x.ai)
- Sektsioonis API Keys genereeri uus võti
- Kopeeri see kohe – seda enam uuesti ei näidata
Hoia seda võtit turvaliselt. Ära kunagi salvesta seda Git-i hoidlasse ega jaga meeskonna vestluses. Kasuta keskkonnamuutujat või saladuste haldurit.
Saadaolevad lõpp-punktid
grok-build-0.1 toetab järgmisi lõpp-punkte, kõik OpenAI vormingus:
/v1/chat/completions: teksti ja koodi genereerimine (kõige sagedamini kasutatav)/v1/chat/completionsparameetrigastream: true: voogedastus koosreasoning_content-iga/v1/chat/completionsparameetrigatools: loomulik tööriistade kutsumine
Ühilduvuse piirangud
Eksisteerib mõni väike erinevus:
- Saadaolevad mudelid on xAI omad (grok-build-0.1, grok-4.5 jne), mitte OpenAI omad
- Mõned OpenAI-spetsiifilised parameetrid (nagu
logprobs) ei pruugi olla toetatud reasoning_contenton spetsiifiline xAI API-le ja seda OpenAI API-s ei eksisteeri
Peamised punktid
- xAI API asub aadressil
https://api.x.ai/v1ja on ühilduv OpenAI vorminguga - Üleminekuks tuleb muuta vaid baas-URL ja API võti
- OpenAI Python SDK töötab kohe
- Hangi API võti aadressilt console.x.ai
- Kõik OpenAI-ga ühilduvad redaktorid töötavad xAI-ga