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

Python SDK на xAI

Урок 5 от 14 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Официалният Python SDK на xAI
  2. Инсталация
  3. Инициализиране на клиента
  4. Изпращане на заявка
  5. Предимства на родния SDK
  6. Кога да изберете този SDK
  7. Ключови изводи

Обновено на 3 ноември 2026 г., въз основа на най-добрите практики и справочника за API на xAI: температурата е ограничена до 1, а препоръчителната стойност е 0.7. Източник: Най-добри практики. Примерът за извикване следва README на SDK (chat.append(user(...)), chat.sample(), response.content) и беше изпълнен за проверка.

Официалният Python SDK на xAI

Родният Python SDK на xAI е най-прекият начин за работа с Grok API. Той предоставя достъп до специфичните функции на платформата и получава актуализации първи, когато се добавят нови модели или крайни точки.

pip
Стандартна инсталация
Client
Основен клас
Auto
Автоматично откриване на API ключ
Native
Пълна поддръжка на xAI

Инсталация

Инсталирайте SDK чрез pip във вашата Python среда:

pip install xai-sdk

Препоръчваме използването на виртуална среда, за да изолирате зависимостите на всеки проект:

python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
pip install xai-sdk

Инициализиране на клиента

Класът Client е входната точка на SDK. Той управлява удостоверяването, HTTP връзките и сериализацията на заявките:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))

Ако променливата на средата XAI_API_KEY е зададена, можете да създадете клиента и без изричен аргумент:

client = Client()

SDK автоматично открива променливата и я използва за удостоверяване.

Изпращане на заявка

След инициализиране на клиента, SDK мисли в термините на разговори: client.chat.create() създава разговора (без да изпраща нищо), append добавя съобщение, построено с user() или system(), а sample() иска отговора от модела:

import os

from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(model="grok-4.7")
chat.append(user("Обясни какво е REST API в 3 изречения."))
response = chat.sample()

print(response.content)

Често използвани параметри

  • model: ID на модела за използване (задължително); xAI препоръчва grok-4.7
  • messages: началните съобщения на разговора, построени с system(), user() и assistant() от xai_sdk.chat (обикновените речници ще доведат до грешка при извикването)
  • temperature: от 0 до 2, ограничена до 1 над тази стойност; xAI препоръчва 0.7, като top_p е 0.95
  • max_tokens: максималният брой генерирани токени
  • reasoning_effort: дълбочината на разсъждението (none, low, medium, high), която xAI препоръчва да се задава при всяка заявка

Стриймингът не минава през параметър: for response, chunk in chat.stream(): връща фрагментите, докато пристигат, в chunk.content. Урок 10 показва стрийминг чрез REST API през SSE.

Предимства на родния SDK

В сравнение със SDK на OpenAI, насочен към API на xAI (следващият урок), родният SDK осигурява директен достъп до функции, специфични за xAI: търсене в X и уеб, сървърни инструменти, генериране на видео, колекции от документи. Пълните му Python типове подсилват автоматичното довършване на кода във вашия редактор, а xAI го поддържа в синхрон с темпото на API. Той има и своя собствена структура, която трябва да приемете: работи през gRPC, съобщенията се изграждат с user() и system(), а грешките са от типа grpc.RpcError.

Кога да изберете този SDK

Изборът следва естествено от вашата ситуация. За нов проект, изграден специално върху Grok API, родният SDK е очевидната отправна точка: получавате всичко изброено по-горе без ограничения за съвместимост. Той става съществен веднага щом планирате да използвате функции, специфични за xAI, като търсене в X или вградено уеб търсене, които работят пълноценно само по този начин. Ако обаче разполагате със съществуващ код, изграден върху SDK на OpenAI, не пренаписвайте нищо засега: следващият урок показва как да го адаптирате, като промените два реда.

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

  • Инсталирайте с pip install xai-sdk във виртуална среда
  • Класът Client е входната точка с автоматично откриване на XAI_API_KEY
  • client.chat.create() създава разговор; chat.append(user(...)) добавя съобщение, а chat.sample() връща отговора, четен от response.content
  • Предпочитайте този SDK за нови проекти, насочени единствено към Grok API