xAI API и съвместимост с OpenAI
На тази страница
Познат API
API на xAI използва същия формат като API на OpenAI. Ако преди сте работили с API на OpenAI или съвместими инструменти, няма нищо ново за учене. Единственото, което се променя, е основният URL адрес.
https://api.x.ai/v1
Тази съвместимост е стратегически избор на xAI. Вместо да налагат нов собствен формат, те приеха де факто индустриалния стандарт. В резултат на това всеки инструмент, SDK или редактор, който поддържа API на OpenAI, може да използва grok-build-0.1 незабавно.
Минимална конфигурация
За да преминете от OpenAI към xAI във всеки съвместим клиент, трябва да промените само два параметъра:
- Основен URL (Base URL): заменете
https://api.openai.com/v1сhttps://api.x.ai/v1 - API ключ: използвайте Вашия API ключ на xAI (получен от
console.x.ai)
Всичко останало – формат на съобщенията, параметри за температура, структура на отговора – е идентично.
Пример с Python SDK на 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."}
]
)
Използвате стандартния SDK на OpenAI без никакви модификации. Променят се само base_url и името на модела.
Пример с 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 ключ
- Отидете на console.x.ai
- Влезте с Вашия акаунт в xAI (или създайте такъв на accounts.x.ai)
- В секцията API Keys генерирайте нов ключ
- Копирайте го веднага – няма да бъде показан отново
Пазете този ключ в сигурност. Никога не го качвайте в Git хранилище и не го споделяйте в чатове на екипа. Използвайте променлива на средата или мениджър на тайни.
Налични крайни точки (Endpoints)
grok-build-0.1 поддържа следните крайни точки, всички във формат на OpenAI:
/v1/chat/completions: генериране на текст и код (най-често използваната)/v1/chat/completionsсstream: true: поточно предаване сreasoning_content/v1/chat/completionsсtools: нативно извикване на инструменти
Ограничения на съвместимостта
Съществуват няколко малки разлики:
- Наличните модели са на xAI (grok-build-0.1, grok-4.5 и др.), а не на OpenAI
- Някои параметри, специфични за OpenAI (като
logprobs), може да не се поддържат reasoning_contentе специфично за API на xAI и не съществува в API на OpenAI
Ключови изводи
- API на xAI се намира на
https://api.x.ai/v1и е съвместим с формата на OpenAI - Трябва да промените само основния URL и API ключа, за да мигрирате
- Python SDK на OpenAI работи без промени
- Вземете API ключа от console.x.ai
- Всички редактори, съвместими с OpenAI, работят с xAI