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

OpenAI SDK за Grok

Урок 6 от 14 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Използвайте знанията си за OpenAI
  2. Инсталация
  3. Конфигуриране на клиента за xAI
  4. Изпращане на съобщение
  5. Мигриране на съществуващ проект за OpenAI
  6. Разлики, които трябва да знаете
  7. Кога да изберете този подход
  8. Ключови изводи

Обновено на 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) не се поддържат при моделите за разсъждение