Премини към основното съдържание
Български— Изберете език
Меню

xAI API и съвместимост с OpenAI

Урок 4 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Познат API
  2. Минимална конфигурация
  3. Получаване на API ключ
  4. Налични крайни точки (Endpoints)
  5. Ограничения на съвместимостта
  6. Ключови изводи

Познат API

API на xAI използва същия формат като API на OpenAI. Ако преди сте работили с API на OpenAI или съвместими инструменти, няма нищо ново за учене. Единственото, което се променя, е основният URL адрес.

https://api.x.ai/v1

Тази съвместимост е стратегически избор на xAI. Вместо да налагат нов собствен формат, те приеха де факто индустриалния стандарт. В резултат на това всеки инструмент, SDK или редактор, който поддържа API на OpenAI, може да използва grok-build-0.1 незабавно.

Минимална конфигурация

За да преминете от OpenAI към xAI във всеки съвместим клиент, трябва да промените само два параметъра:

  1. Основен URL (Base URL): заменете https://api.openai.com/v1 с https://api.x.ai/v1
  2. 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 ключ

  1. Отидете на console.x.ai
  2. Влезте с Вашия акаунт в xAI (или създайте такъв на accounts.x.ai)
  3. В секцията API Keys генерирайте нов ключ
  4. Копирайте го веднага – няма да бъде показан отново

Пазете този ключ в сигурност. Никога не го качвайте в 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