OpenAI SDK за Grok
На тази страница
Обновено на 3 ноември 2026 г., въз основа на страницата Models на xAI: grok-4.7 (септември 2026 г.) замести grok-4.5 като препоръчителен модел; примерът, написан с grok-4.5, работи и с grok-4.7. Източници: Models · Release notes.
Изяснено на 3 ноември 2026 г., въз основа на справочника за Chat Completions на xAI: извикването не е строго идентично с това на OpenAI;
logprobsиtop_logprobs(игнорирани отgrok-4.20нататък) иlogit_bias(не се поддържа) добавят към разликите, изброени по-долу. Източник: xAI, Chat Completions.
Използвайте знанията си за OpenAI
Ако вече работите с OpenAI SDK в Python, можете да го използвате както си е, за да извиквате Grok API. Просто пренасочете заявките към сървърите на xAI, като промените базовия URL. Това е най-бързият подход, ако разполагате със съществуващ код.
Инсталация
Ако OpenAI SDK все още не е инсталиран във вашия проект:
pip install openai
Конфигуриране на клиента за xAI
Единствената разлика спрямо стандартната употреба на 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"
)
Това е всичко. От този момент нататък всеки метод в OpenAI SDK работи с моделите на Grok.
Изпращане на съобщение
Извикването има същата структура като при GPT, с изключение на неподдържаните параметри (вижте по-долу):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Налични модели
Просто заменете името на модела на OpenAI с модел на Grok:
grok-4.7: моделът, препоръчан от xAI, универсален, с възможност за входни изображения (grok-4.6иgrok-4.5остават налични)grok-4.20-0309-reasoning: разширено разсъждениеgrok-4.3: бързи и евтини отговори (контекст от 1M)
Мигриране на съществуващ проект за OpenAI
За да адаптирате съществуващ проект, имате две опции.
Опция 1: Променливи на средата
Променете променливите си, без да пипате кода:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
OpenAI SDK чете тези променливи автоматично. Съществуващият ви код ще работи, ако също така промените името на модела и премахнете параметрите, които xAI не поддържа.
Опция 2: Явна конфигурация
Напишете функция за инициализация, която превключва между доставчиците:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI по подразбиране
client = create_client("xai")
Този подход ви позволява лесно да превключвате между доставчиците по време на миграцията.
Разлики, които трябва да знаете
Въпреки че API е съвместим, някои поведения се различават:
- Параметрите
frequency_penaltyиpresence_penaltyне се поддържат при моделите за разсъждение - Параметърът
stopне е наличен при моделите за разсъждение logprobsиtop_logprobsсе игнорират мълчаливо отgrok-4.20и по-новите модели, аlogit_biasне се поддържа- Имената на моделите очевидно са различни
- Някои функции на xAI (търсене в X, уеб търсене) не са налични чрез стандартния формат на OpenAI
Кога да изберете този подход
Режимът на съвместимост има най-голям смисъл, когато съществуващият ви код е по-важен от ексклузивните функции. Най-честият случай е миграцията: код, вече написан за OpenAI, преминава към Grok чрез промяна на базовия URL и ключа: два реда, без пренаписване. Обратимостта също има значение: докато оставате във формата на OpenAI, превключването на доставчици остава въпрос на конфигурация, което е ценно за сравняване на модели или преговори. След това идва екосистемата: инструменти на трети страни, изградени около OpenAI SDK, като LangChain и LlamaIndex, работят веднага, а екип, който вече познава SDK, няма нужда да учи нищо ново. Цената, която плащате, е тази, която видяхте по-горе: функциите, специфични за xAI, остават на заден план.
Ключови изводи
- Добавете
base_url="https://api.x.ai/v1"към конструктораOpenAI() - Заменете API ключа и името на модела
- Променливите
OPENAI_BASE_URLиOPENAI_API_KEYпозволяват миграция без промяна на кода - Някои параметри (наказания, stop) не се поддържат при моделите за разсъждение