Руководство по интеграции xAI Grok API: модели, цены и настройка (2026)

API xAI Grok даёт OpenAI-совместимый доступ к одним из самых сильных моделей рассуждения на рынке — от контекста в 1 миллион токенов у Grok 4.3 до $0.30 за миллион входных токенов у Grok 3 Mini. Если вы уже используете SDK OpenAI, интеграция с xAI занимает две строки кода: измените base_url и замените имя модели.

Мы пропустили реальный производственный трафик через эндпоинт xAI и протестировали каждую модель в их линейке. В этом руководстве — полное семейство модели, цены на июнь 2026 года, рабочие примеры кода,常见ные ошибки, с которыми мы столкнулись, и способ интеграции xAI в многопровайдерную маршрутизацию.

Быстрый старт: API xAI за 3 минуты

Шаг 1 — Получите API-ключ. Зарегистрируйтесь на console.x.ai. xAI предлагал разработчикам до $150/месяц бесплатных кредитов через программу обмена данными (проверьте текущую доступность в консоли). Создайте API-ключ в разделе Settings → API Keys.

Шаг 2 — Установите SDK OpenAI (если ещё не установлен):

pip install openai

Шаг 3 — Сделайте первый вызов:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.x.ai/v1",
    api_key="your-xai-api-key",
)

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{"role": "user", "content": "Объясните квантовые вычисления в одном абзаце."}],
)
print(response.choices[0].message.content)

И всё. API xAI полностью совместим с OpenAI — вызов инструментов, структурированный вывод, потоковая передача и работа с изображениями работают через тот же SDK. Специальная библиотека xAI не нужна.

Семейство моделей Grok

Текущая линейка API xAI (июнь 2026) включает пять ценовых уровней:

Цены из docs.x.ai/developers/models, получены в июне 2026.

Ключевое наблюдение по ценам: Grok 4.3 на 58% дешевле по входу и на 83% дешевле по выходу по сравнению с оригинальным Grok 4. Цена кэшированного входа ($0,20/M) — скидка 84%, что очень ценно для агентных циклов, где системный промпт остаётся неизменным между запросами.

Grok 4.3 — Выбор по умолчанию

Grok 4.3 — текущий флагман xAI, выпущенный 30 апреля 2026 года. Поставляется с рассуждением по умолчанию (цепочка мыслей встроена, переключатель не нужен), нативным вводом видео (mp4/mov/webm, до 5 мин, 1080p) и нативной генерацией артефактов (PDF, PowerPoint, таблицы). Документация xAI рекомендует его для всех сценариев чата и кодирования.

Важный момент с псевдонимами: на стороне xAI grok-4, grok-4-latest, grok-4-0709, grok-3, grok-3-mini и другие в настоящее время разрешаются в Grok 4.3. Если нужна оригинальная модель Grok 4, используйте закреплённый снапшот grok-4-0709.

Варианты Grok 4.20 — Когда нужен гранулярный контроль

Три варианта Grok 4.20 позволяют явно выбрать поведение рассуждения:

• grok-4.20-0309-reasoning — цепочка мыслей включена, лучше для математики и многошаговой логики
• grok-4.20-0309-non-reasoning — стандартные дополнения, ниже задержка
• grok-4.20-multi-agent-0309 — 2M контекст для мультиагентной оркестрации

Все три имеют одинаковую цену ($1,25/$2,50/M). Выбирайте между reasoning и non-reasoning в зависимости от бюджета задержки.

Grok 4.1 Fast — Бюджетная рабочая лошадка

По $0,20/$0,50 за миллион токенов с контекстным окном в 2M, Grok 4.1 Fast обеспечивает качество, близкое к флагманскому, примерно за 1/15 цены Grok 4. Для большинства чат-ботов, RAG и агентных задач по кодированию — это правильный выбор по умолчанию. Кэшированный вход $0,05/M при масштабировании фактически бесплатен.

Устаревшие модели (Grok 4, Grok 3, Grok 3 Mini)

Grok 4 и Grok 3 стоят $3,00/$15,00/M — значительно дороже новых моделей без преимущества в качестве. Grok 4.1 Fast превосходит Grok 3 по большинству бенчмарков за долю цены.

Исключение — Grok 3 Mini ($0,30/$0,50/M) — по-прежнему полезен для бюджетных задач рассуждения в существующих интеграциях, которые ещё не мигрировали.

⚠️ Grok 4, Grok 3, Grok 3 Mini и Grok 4.1 Fast могут не отображаться на текущей публичной странице цен xAI. Они могут быть устаревшими или доступными только для корпоративных клиентов. Проверьте доступность в консоли xAI перед разработкой.

Примеры кода по сценариям

Chat completion

from openai import OpenAI

client = OpenAI(
    base_url="https://api.x.ai/v1",
    api_key="your-xai-api-key",
)

# Grok 4.3 — текущий флагман
response = client.chat.completions.create(
    model="grok-4.3",
    messages=[
        {"role": "system", "content": "Вы старший бэкенд-инженер."},
        {"role": "user", "content": "Спроектируйте rate limiter для распределённого API-шлюза."},
    ],
)
print(response.choices[0].message.content)

Vision (изображение + текст)

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": "https://example.com/architecture.png"}},
            {"type": "text", "text": "Опишите архитектуру и выявите потенциальные узкие места."},
        ],
    }],
)

Ограничения изображений: Максимум 20 МиБ на изображение, только jpg/jpeg или png. Без ограничения на количество изображений в запросе. Порядок ввода текста и изображений произвольный.

Вызов функций (инструментов)

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{"role": "user", "content": "Какая погода в Токио?"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "get_weather",
            "description": "Получить текущую погоду для локации",
            "parameters": {
                "type": "object",
                "properties": {
                    "location": {"type": "string", "description": "Название города"},
                    "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]},
                },
                "required": ["location"],
            },
        },
    }],
    tool_choice="auto",
)

Структурированный вывод (JSON)

import json

response = client.chat.completions.create(
    model="grok-4.3",
    messages=[{"role": "user", "content": "Перечислите 3 языка программирования с годом их создания."}],
    response_format={"type": "json_object"},
)
data = json.loads(response.choices[0].message.content)

Потоковая передача

stream = client.chat.completions.create(
    model="grok-4.3",
    messages=[{"role": "user", "content": "Напишите хайку об API."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

Выбор подходящей модели Grok

Лимиты запросов

Все модели xAI API имеют одинаковые лимиты:

• 1 800 запросов/минуту
• 10 000 000 токенов/минуту

Этих лимитов достаточно для большинства нагрузок. Если нужны более высокие лимиты, обратитесь в корпоративный отдел xAI.

Частые ошибки и решения

1. «Model not found» после миграции

Проблема: Использовали grok-4 и он вдруг возвращает Grok 4.3 вместо оригинальной модели.

Причина: xAI объединил устаревшие псевдонимы. grok-4, grok-4-latest, grok-3, grok-3-mini и другие на стороне xAI с мая 2026 разрешаются в Grok 4.3.

Решение: Используйте закреплённый снапшот grok-4-0709 для стабильного поведения Grok 4, или явно используйте grok-4.3 для текущего флагмана.

2. Ошибка загрузки изображений

Проблема: Ошибка 400 при отправке изображений.

Причина: xAI принимает только jpg/jpeg и png. Максимум 20 МиБ на изображение.

Решение: Конвертируйте другие форматы (webp, gif, bmp) в png перед загрузкой. Уменьшайте изображения свыше 20 МиБ.

3. logprobs возвращает null

Проблема: Установлены logprobs и top_logprobs, но вероятности по токенам не возвращаются.

Причина: На моделях Grok 4.20 и новее (включая 4.3) logprobs и top_logprobs игнорируются без ошибки. API принимает параметры, но не возвращает данные.

Решение: Если нужны logprobs, используйте модель от другого провайдера.

4. Отсутствие данных в реальном времени

Проблема: Grok не знает о последних событиях.

Причина: У Grok 3 и Grok 4 дата отсечения знаний — ноябрь 2024. У Grok 4.3 дата отсечения не раскрывается публично, но встроенных знаний в реальном времени также нет.

Решение: Включайте серверные инструменты web-search или X (Twitter) search xAI для каждого запроса. Важно: эти инструменты нативны для xAI и не пересылаются через прокси или маршрутизацию — для получения актуальной информации вызывайте API xAI напрямую.

5. Неожиданное разрешение псевдонимов

Проблема: Код использует grok-3-mini, но вы получаете ответы качества Grok 4.3 (и цену Grok 4.3).

Причина: Объединение псевдонимов. Используемый вами слаг разрешается в другую модель.

Решение: Проведите аудит слагов моделей. Проверьте документацию xAI на актуальную карту псевдонимов. Используйте слаги с фиксированной датой (например, grok-4-0709) для воспроизводимого поведения.

Чеклист перед продакшеном

Перед развёртыванием xAI убедитесь:

• Закрепите слаг модели. Используйте идентификаторы с фиксированной датой (grok-4-0709) или явные версионные слаги (grok-4.3), а не плавающие псевдонимы (grok-4, grok-latest)
• Установите таймаут. У Grok 4.3 рассуждение всегда включено, что увеличивает TTFT (~11,6 с по измерениям сообщества). Установите таймаут клиента соответствующим образом
• Обрабатывайте лимиты. Реализуйте экспоненциальную задержку для ответов 429. Лимиты: 1 800 запросов/мин, 10M токенов/мин
• Кэшируйте агрессивно. Кэшированный вход ($0,20/M vs $1,25/M) — скидка 84%. Отправляйте стабильные системные промпты как кэшированный контекст
• Мониторьте расходы по моделям. Grok 4.3 по $1,25/$2,50/M — доступно; устаревший Grok 4 по $3,00/$15,00/M — нет. Убедитесь, что логика маршрутизации выбирает правильную модель
• Валидируйте входные изображения. Проверяйте формат jpg/png и лимит 20 МиБ перед отправкой в API
• Не полагайтесь на logprobs. На моделях Grok 4.20+ они игнорируются без ошибки
• Тестируйте потоковую передачу отдельно. Поведение потоков может различаться между reasoning и non-reasoning вариантами
• Планируйте дрейф псевдонимов. xAI исторически объединяла псевдонимы без предупреждения. Создайте мониторинг для обнаружения неожиданных изменений поведения моделей

Маршрутизация xAI через TheRouter

Если вы управляете несколькими AI-провайдерами, маршрутизация xAI через TheRouter даёт единый OpenAI-совместимый эндпоинт с автоматическим переключением, отслеживанием использования и контролем затрат.

Для маршрутизации к xAI через TheRouter используйте слаг модели с префиксом провайдера:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.therouter.ai/v1",
    api_key="your-therouter-api-key",
)

# xAI Grok 4.3 через TheRouter
response = client.chat.completions.create(
    model="xai/grok-4.3",
    messages=[{"role": "user", "content": "Объясните теорему CAP на конкретных примерах."}],
)

# Переключение на другой провайдер — тот же SDK, тот же код
response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4",
    messages=[{"role": "user", "content": "Объясните теорему CAP на конкретных примерах."}],
)

Страница провайдера xAI на TheRouter перечисляет все доступные слаги моделей и их текущие цели маршрутизации. Каждая модель в TheRouter привязана к конкретному слагу API xAI — например, xai/grok-4 закреплён за снапшотом grok-4-0709 для стабильности, а xai/grok-4.3 отслеживает текущее поколение xAI.

Что TheRouter добавляет для пользователей xAI:

• Единый биллинг — один счёт за xAI и другие провайдеры
• Автоматическое переключение — если xAI недоступен, маршрутизация к эквивалентной модели от другого провайдера
• Корпоративное управление — API-ключи, квоты использования и журналы аудита для каждого члена команды
• Слаги моделей с префиксом провайдера — ваш код никогда не захардкодит эндпоинт одного провайдера

За пределами чата: голос, изображения и видео

xAI также предоставляет специализированные API помимо chat completions:

Эти специализированные API отделены от пути chat/completions и не экспонируются через стандартную маршрутизацию TheRouter. Для работы с изображениями, видео и голосом используйте API xAI напрямую.

FAQ

В: API xAI действительно совместим с OpenAI?

Да — эндпоинт /v1/chat/completions, вызов инструментов, структурированный вывод, потоковая передача и vision следуют спецификации API OpenAI. Известное отличие: logprobs и top_logprobs молча игнорируются на Grok 4.20 и новее.

В: Чем Grok 4.3 отличается от Grok 4.20?

Grok 4.3 (апрель 2026) — текущий флагман с рассуждением по умолчанию, нативным видеовводом и генерацией артефактов. Grok 4.20 (февраль 2026) выпускается в трёх вариантах (reasoning, non-reasoning, multi-agent) с явным контролем рассуждения. Обе модели стоят $1,25/$2,50/M. Для новых проектов начинайте с Grok 4.3, если не нужен вариант non-reasoning для снижения задержки или multi-agent для контекста в 2M.

В: Можно ли отключить рассуждение в Grok 4.3?

Нет. Цепочка мыслей в Grok 4.3 всегда включена и не может быть отключена через API. Если нужно поведение без рассуждений, используйте grok-4.20-non-reasoning. Компромисс: TTFT Grok 4.3 ~11,6 секунды (по измерениям сообщества) против более низкой задержки для нерассуждающих моделей.

В: xAI предоставляет бесплатные кредиты?

xAI предлагал до $150/месяц бесплатных кредитов через программу обмена данными. Проверьте текущую доступность в консоли xAI — программа подвергалась изменениям.

В: Как xAI сравнивается с OpenAI и Anthropic?

Grok 4.3 от xAI стоит $1,25/$2,50/M — значительно дешевле GPT-5.5 от OpenAI или Claude Opus 4.7 от Anthropic по выходным токенам. В Artificial Analysis Intelligence Index Grok 4.3 набирает 53 (против 60 у GPT-5.5 и 57 у Gemini 3.1 Pro Preview). Сильная сторона xAI — агентный вызов инструментов и долгосрочные многошаговые задачи, где оценки сообщества показывают конкурентоспособность с моделями, стоящими в 9 раз дороже.

В: Какие регионы обслуживает xAI?

API xAI доступен в us-east-1, eu-west-1 и us-west-2. Если нужен низкозадержечный доступ из Азии, рассмотрите маршрутизацию через TheRouter для оптимизации регионального роутинга.

---

Источники: Документация моделей xAI (получена в июне 2026), Документация модели xAI Grok 4.3, Примечания к выпускам xAI. Цены проверены по публичной документации xAI и перекрёстно сверены с анализом цен mem0.ai (май 2026). Данные бенчмарков от Artificial Analysis и оценок сообщества.