Grok API: интеграция Grok в ваши проекты

Два способа подключить Grok через код

Разработчики могут обращаться к моделям Grok двумя основными путями. Первый — официальный xAI API от самой компании (сейчас под брендом SpaceXSI), ключи для которого создаются на console.x.ai. Второй — агрегаторы моделей, такие как OpenRouter: они дают доступ к моделям разных провайдеров по единому ключу и общему счету. Оба варианта поддерживают формат OpenAI Chat Completions, поэтому официальные библиотеки OpenAI работают сразу — достаточно лишь указать другой базовый адрес и имя модели.

Какой вариант выбрать

• xAI API — если вы хотите первыми получать все новинки Grok: полный список моделей, Responses API, серверный поиск по веб-страницам и публикациям в X, генерацию картинок и видео через Grok Imagine, голосовой режим, пакетную обработку (batch) и скидки за кэширование промптов. Базовый адрес: https://api.x.ai/v1.
• OpenRouter — если вам нужно переключаться между Grok и моделями других разработчиков без отдельных договоров или у вас уже есть аккаунт на OpenRouter. Базовый адрес: https://openrouter.ai/api/v1, к идентификаторам моделей добавляется префикс x-ai/. Настройка описана в руководстве OpenRouter.

В любом случае храните ключ на сервере или в переменных окружения. Никогда не вшивайте его в код веб-страниц или мобильных приложений, где его может прочесть любой желающий.

Первый запрос к xAI API

Создайте ключ в панели управления, сохраните его в переменную XAI_API_KEY и отправьте сообщение модели Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Дай три совета для подготовки к первому марафону."}
    ]
  }'

Python с библиотекой OpenAI

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Число 391 простое? Покажи ход проверки."}],
)
print(answer.choices[0].message.content)

Параметр reasoning_effort определяет, насколько долго модель размышляет перед ответом. Grok 4.3 принимает значения none, low, medium, high и xhigh (по умолчанию — low); Grok 4.7 принимает low, medium, high и xhigh (по умолчанию — high). Для Grok 4.20 компания xAI использует отдельные идентификаторы: grok-4.20-0309-reasoning и grok-4.20-0309-non-reasoning.

То же самое через OpenRouter

При работе с OpenRouter сохраните ключ в OPENROUTER_API_KEY и используйте идентификаторы с префиксом x-ai/. В OpenRouter рассуждения настраиваются через объект reasoning. Пример на JavaScript для Node.js 18 и новее:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Перепиши этот заголовок в более спокойном тоне: ЦЕНЫ СНОВА ВЗЛЕТЕЛИ ДО НЕБЕС" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Чтобы модель размышляла над ответом, передайте reasoning: { effort: "low" } (или medium, high). Добавьте exclude: true, если рассуждения нужны для формирования ответа, но их текст возвращать не требуется. Установите stream: true для потоковой выдачи ответа по мере генерации — в интерфейсах чата это ощущается значительно быстрее.

Отправка изображений

Модели Grok 4.20, 4.3 и 4.7 умеют распознавать изображения. Передавайте их стандартным для OpenAI способом — списком блоков контента. По документации xAI поддерживаются форматы JPEG и PNG размером до 20 МиБ; подходят как публичные ссылки, так и base64 в формате Data URL.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "Перечисли позиции и общую сумму в этом чеке."}
    ]
  }]
}

Идентификаторы моделей Grok и тарифы

Ниже перечислены актуальные текстовые модели SpaceXAI, доступные в OpenRouter, с размером контекста и ценами за миллион токенов (базовые тарифы OpenRouter на октябрь 2026 года). В xAI API действуют те же базовые цены для промптов объемом до 200 000 токенов.

Важные нюансы со страницы моделей и тарифов xAI (октябрь 2026 года):

• Длинные промпты стоят дороже. Если объем промпта превышает 200 000 токенов, весь запрос тарифицируется по повышенной ставке: $4 / $12 для Grok 4.7 и $2.50 / $5 для Grok 4.3 и 4.20.
• Скидки за кэширование входных данных: $0.50 за миллион токенов для Grok 4.7 и $0.20 для Grok 4.3 и 4.20 при повторении одинаковых фрагментов контекста.
• Пакетная обработка (batch) не срочных задач стоит дешевле; на OpenRouter модель x-ai/grok-4.3:batch доступна по цене $1 / $2.
• Разница в лимитах контекста: OpenRouter указывает 2 000 000 токенов для Grok 4.20, тогда как на сайте xAI заявлен 1 000 000.

Токены рассуждений тарифицируются как выходные, поэтому итоговая стоимость ответа думающей модели может быть выше, чем кажется на первый взгляд.

Практические советы

• Начинайте с Grok 4.20 без рассуждений для задач чата, перефразирования и извлечения данных. Она работает быстро и стоит недорого. Переходите на Grok 4.3 или 4.7, когда качество сложных ответов важнее скорости.
• Учитывайте актуальность данных. По данным xAI, база знаний Grok 4.7 ограничена маем 2026 года. Для более свежей информации передавайте факты в промпте или используйте встроенные инструменты xAI для поиска по сети и X (оплачиваются отдельно за вызов).
• Задавайте системное сообщение: указывайте роль, тональность и желаемый формат ответа. Если ответ нужно обработать программно, требуйте JSON с нужной схемой.
• Обрабатывайте ограничения частоты запросов. При получении ошибки 429 сделайте небольшую паузу и повторите попытку.
• Соблюдайте правила платформы. К запросам через API применяются правила допустимого использования xAI, а параметр safety_identifier позволяет помечать запросы конкретных конечных пользователей.

Если что-то пошло не так

• Ошибки 401 или 403: ключ не указан, отозван или загружен не из того окружения. Выведите первые символы ключа в логах сервера, чтобы убедиться, что он прочитан корректно.
• Model not found: проверьте правильность имени. Для OpenRouter нужен префикс x-ai/grok-4.7, для xAI — просто grok-4.7.
• Пустой или слишком долгий ответ у думающей модели чаще всего означает, что лимит токенов ушел на рассуждения. Уменьшите параметр effort или увеличьте max_tokens.
• Изображение отклонено: убедитесь, что файл сохранен в формате JPEG или PNG и не превышает лимит по размеру.

Частые вопросы

Совместим ли Grok API с библиотеками OpenAI?

Да. Настройте SDK на адрес https://api.x.ai/v1 с ключом xAI либо на адрес OpenRouter с их ключом и укажите нужное имя модели Grok.

Есть ли бесплатный доступ к Grok API?

Постоянного бесплатного тарифа нет. И xAI, и OpenRouter взимают плату за токены, хотя короткие тесты обходятся в копейки.

Можно ли создавать картинки через Grok API?

Да, с помощью моделей Grok Imagine от xAI через отдельный эндпоинт для работы с изображениями. Подробнее читайте на странице Grok Imagine. В нашем веб-чате генерация изображений не предусмотрена.

Какую модель Grok использует Grok.Online?

В нашем чате доступны Grok 4.20 с выключенным режимом рассуждений, Grok 4.3 с минимальным уровнем размышлений и до 10 сообщений в день к Grok 4.7 — все запросы идут через OpenRouter.