Python SDK на xAI
На тази страница
Обновено на 3 ноември 2026 г., въз основа на най-добрите практики и справочника за API на xAI: температурата е ограничена до 1, а препоръчителната стойност е 0.7. Източник: Най-добри практики. Примерът за извикване следва README на SDK (
chat.append(user(...)),chat.sample(),response.content) и беше изпълнен за проверка.
Официалният Python SDK на xAI
Родният Python SDK на xAI е най-прекият начин за работа с Grok API. Той предоставя достъп до специфичните функции на платформата и получава актуализации първи, когато се добавят нови модели или крайни точки.
Инсталация
Инсталирайте 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.7messages: началните съобщения на разговора, построени сsystem(),user()иassistant()отxai_sdk.chat(обикновените речници ще доведат до грешка при извикването)temperature: от 0 до 2, ограничена до 1 над тази стойност; xAI препоръчва 0.7, катоtop_pе 0.95max_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