Семейство Grok

Модели Grok от xAI: reasoning-модели Grok 4.7, 4.6, 4.5, 4.3 и не-reasoning-модели Grok 4.1 Fast и 4.20. Вызываются через OpenAI-совместимый API.

Частые задачи

Модели

Полный список моделей и актуальные цены см. на странице моделей . Префикс ID модели — x-ai/, его можно опустить.

Поддержка эндпоинтов

Модели Grok предоставляет официальный провайдер xAI (grok); у некоторых моделей есть также провайдер Azure AI Foundry.

Примеры вызова

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="x-ai/grok-4.7",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "Объясни одним предложением, что такое идемпотентность."}],
)
print(resp.choices[0].message.content)
print("Токены reasoning:", resp.usage.completion_tokens_details.reasoning_tokens)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "x-ai/grok-4.7",
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "Объясни одним предложением, что такое идемпотентность."}]
  }'

Reasoning

Замер на одной и той же математической задаче: Grok 4.7 по умолчанию тратит на reasoning около 15 тыс. токенов и около 4 минут; с reasoning_effort: "low" — около 4200 токенов и около 1 минуты. Токены reasoning оплачиваются по цене выходных токенов, их число указано в usage.completion_tokens_details.reasoning_tokens; содержимое reasoning передаётся в потоковом ответе в delta.reasoning_content.

Другие возможности

• Ввод изображений: поддерживают Grok 4.3, 4.20 и 4.1 Fast; используется стандартный блок контента image_url, см. Распознавание изображений.
• Структурированный вывод и вызов инструментов: response_format поддерживает json_schema; для вызова инструментов используется стандартный параметр tools.
• Кэширование: повторяющиеся префиксы запросов кэшируются автоматически, объём попаданий указан в usage.prompt_tokens_details.cached_tokens.

Распространённые ошибки

Другие общие ошибки — в разделе Обработка ошибок.

Официальная документация

• xAI · Документация 

Часто задаваемые вопросы