xAI API ja OpenAI-yhteensopivuus
Tällä sivulla
Tuttu API
xAI:n API käyttää samaa muotoa kuin OpenAI:n API. Jos olet aiemmin työskennellyt OpenAI:n API:n tai yhteensopivien työkalujen kanssa, sinun ei tarvitse opetella mitään uutta. Ainoa asia, joka muuttuu, on perus-URL-osoite.
https://api.x.ai/v1
Tämä yhteensopivuus on xAI:n strateginen valinta. Uuden suljetun muodon sijaan he omaksuivat alan epävirallisen standardin. Tämän ansiosta mikä tahansa työkalu, SDK tai editori, joka tukee OpenAI:n API:a, voi käyttää grok-build-0.1-mallia välittömästi.
Minimaalinen konfiguraatio
Vaihtaaksesi OpenAI:sta xAI:hon missä tahansa yhteensopivassa asiakasohjelmassa, sinun tarvitsee muuttaa vain kahta parametria:
- Perus-URL: korvaa
https://api.openai.com/v1osoitteellahttps://api.x.ai/v1 - API-avain: käytä xAI:n API-avaintasi (saat sen osoitteesta
console.x.ai)
Kaikki muu – viestien muoto, lämpötilaparametrit ja vastauksen rakenne – on identtinen.
Esimerkki OpenAI:n Python-SDK:lla
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."}
]
)
Käytät standardia OpenAI-SDK:ta ilman muutoksia. Vain base_url ja mallin nimi muuttuvat.
Esimerkki curlilla
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"}
]
}'
Hanki API-avain
- Siirry osoitteeseen console.x.ai
- Kirjaudu sisään xAI-tililläsi (tai luo tili osoitteessa accounts.x.ai)
- Luo uusi avain API Keys -osiossa
- Kopioi se heti – sitä ei näytetä uudelleen
Pidä tämä avain turvassa. Älä koskaan commitoi sitä Git-varastoon tai jaa sitä tiimin chatissa. Käytä ympäristömuuttujaa tai salaisuuksien hallintatyökalua.
Käytettävissä olevat päätepisteet
grok-build-0.1 tukee seuraavia päätepisteitä, jotka kaikki noudattavat OpenAI-muotoa:
/v1/chat/completions: tekstin ja koodin generointi (käytetyin)/v1/chat/completionsparametrillastream: true: suoratoisto mukanareasoning_content/v1/chat/completionsparametrillatools: natiivi työkalukutsujen tuki
Yhteensopivuusrajoitukset
Joitakin pieniä eroja on olemassa:
- Käytettävissä olevat mallit ovat xAI:n omia (grok-build-0.1, grok-4.5 jne.), eivät OpenAI:n
- Jotkut vain OpenAI:lle tarkoitetut parametrit (kuten
logprobs) eivät välttämättä ole tuettuja reasoning_contenton spesifi xAI:n API:lle eikä sitä ole olemassa OpenAI:n API:ssa
Keskeiset asiat
- xAI:n API osoitteessa
https://api.x.ai/v1on yhteensopiva OpenAI-muodon kanssa - Siirtyminen vaatii vain perus-URL:n ja API-avaimen vaihtamisen
- OpenAI:n Python-SDK toimii sellaisenaan
- Saat API-avaimen osoitteesta console.x.ai
- Kaikki OpenAI-yhteensopivat editorit toimivat xAI:n kanssa