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

API на xAI за разработчици

Урок 15 от 16 Обновен 29 юли 2026 г. Начинаещ
На тази страница
  1. Интегриране на Grok във Вашите приложения
  2. Предпоставки
  3. Първоначална настройка
  4. Първата Ви заявка
  5. Какво предоставя API
  6. Избор на модел
  7. Лимити на скоростта и най-добри практики
  8. Ключови изводи

Интегриране на Grok във Вашите приложения

Всичко, което сте се научили да правите в интерфейса на Grok, може да бъде задействано от Вашия собствен код. API на xAI пренася тези възможности във Вашите приложения, уебсайтове и услуги: разговорът спира да бъде място, което посещавате, и се превръща във функция, която Вашият продукт извиква.

Предпоставки

Преди да напишете първия ред код, Ви трябват четири неща:

  1. Акаунт в xAI, създаден на accounts.x.ai
  2. API ключ, генериран на console.x.ai
  3. Настроен начин на плащане (за да надхвърлите безплатния лимит)
  4. Среда за разработка на Python или JavaScript

Първите две неща вече сте направили в този курс: акаунтът управлява автентикацията, а ключът идентифицира Вашето приложение пред API. Начинът на плащане влиза в сила едва когато използването Ви надхвърли безплатния лимит, което се случва по-бързо, отколкото си мислите, щом една услуга работи непрекъснато. Що се отнася до средата, Python и JavaScript разполагат с най-добрите инструменти, но тъй като API комуникира чрез HTTP, всеки език, способен да изпрати заявка, ще свърши работа.

Първоначална настройка

Първата стъпка е да съхраните Вашия API ключ сигурно, в променлива на средата:

export XAI_API_KEY="xai-your-key-here"

Никога не вграждайте ключа си директно в изходния код. Причината е проста: ключ, записан във файл, рано или късно попада в Git хранилище, а ключ, качен в публично хранилище, бива експлоатиран в рамките на минути от ботове, които сканират комитовете, докато сметката остава на Ваше име.

Следва изборът на SDK. Нативният xAI SDK за Python се инсталира с pip install xai-sdk. Ако Вашият код вече извиква OpenAI, библиотеката openai работи както си е, благодарение на съвместимостта на форматите. От страна на JavaScript, добавяте Vercel AI SDK с npm install ai @ai-sdk/xai и той се интегрира с приложения на React и Next.js.

Първата Ви заявка

С нативния SDK създаването на клиент и започването на разговор отнема три реда:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")

Пътят, съвместим с OpenAI, е също толкова директен: променя се само base_url в сравнение със съществуващия код, затова много екипи преминават към него за няколко минути.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.5",
    input="Explain machine learning to me in 3 sentences."
)

За да проверите дали ключът работи, преди дори да сте написали код, нищо не може да замени повикване от командния ред:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Hi, how are you?"
  }'

Какво предоставя API

Основата е генерирането на текст (разговорни отговори, писане, анализ), заедно с режим на разсъждение, който решава сложни проблеми стъпка по стъпка. Стриймингът добавя към това, доставяйки отговора токен по токен, вместо да чакате генерирането да приключи.

Втори набор осигурява достъп до информация: търсене в реално време в уеб и в X, както и RAG, което прави заявки към колекции от документи, които сте изградили. Мультимодалната страна обхваща разбиране на предоставени от Вас изображения, генериране на изображения и видеоклипове с grok-imagine, както и глас, с говорими разговори и TTS (текст към реч).

Накрая, три механизма правят API програмруем в строгия смисъл: извикване на функции, което позволява на модела да извиква Ваши собствени функции; структурирани изходи, които гарантират използваем JSON без крехка пост-обработка; и изпълнение на код от страна на сървъра.

Избор на модел

Разсъждението варира според модела. grok-4.7, водещият модел, предлага конфигурируемо разсъждение: параметърът reasoning_effort (low, medium, high или xhigh) определя колко дълбоко мисли той, заявка по заявка. grok-4.3 остава бюджетният вариант с много дълъг контекст, на приблизително половината цена. Съществуват и версии на моделите без разсъждение за прости задачи: преразказът или класификацията не се нуждаят от вътрешни размисли.

Конвенциите за именуване влияят върху стабилността на Вашето приложение:

  • grok-4.20: най-новата препоръчителна стабилна версия
  • grok-4.20-latest: най-скорошната версия (може да се промени)
  • grok-4.20-0309: версия, фиксирана към конкретна дата (9 март)

В производствена среда фиксирана версия предпазва Вашите промптове от тихи промени в модела; latest е подходяща за проучване, стига да приемате, че поведението може да се измести.

Лимити на скоростта и най-добри практики

API налага лимити на скоростта, за да поддържа услугата стабилна: на входното ниво около 10 милиона токена в минута и 1800 заявки в минута за модели като grok-4.3, като бройките растат с повишаване на нивото Ви. Моделите за генериране на изображения и видео имат свои собствени, много по-ниски тавани – от 30 до 300 заявки в минута в зависимост от модела, затова следете ги внимателно за услуги, насочени към крайни потребители.

Няколко навика разделят прототипа от стабилна интеграция. Включете стрийминг за дълги отговори, защото тридесет секунди пред празен екран изглеждат като прекъсване на услугата. Предавайте ID на разговора, за да се възползвате от кеширане. Насочвайте всяка задача към правилния модел: grok-4.3 за прост обем, grok-4.20 за разсъждение. Обработвайте грешките с повторни опити и експоненциално отстъпване (exponential backoff), иначе пик в трафика ще се превърне в лавина от отхвърлени заявки. И следете използването си в конзолата, преди да откриете totals в края на месеца.

Ключови изводи

  • API на xAI е съвместим с формата на OpenAI, което улеснява миграцията
  • Налични са няколко SDK: нативен xAI, OpenAI и Vercel AI SDK
  • API обхваща текст, изображения, видео, глас и търсене
  • Две нива модели: grok-4.7 (водещ, конфигурируемо разсъждение) и grok-4.3 (бюджетен, 1M контекст)
  • Винаги съхранявайте API ключа си в променлива на средата, никога вграден в кода