- После создания ключа сохраните его в переменной окружения XAI_API_KEY.
- На момент проверки основной универсальный API-моделью xAI называет Grok 4.7.
- Для Grok 4.7 официальная цена на момент проверки составляет $2 за 1 млн входных токенов и $6 за 1 млн выходных токенов.
- Для сайта или приложения безопасная схема выглядит так:
- Для новых интеграций логичнее смотреть в сторону Responses API: xAI развивает его вместе с серверными инструментами и агентными возможностями.
Grok API нужен, когда модель должна работать внутри вашего сайта, приложения, бота или внутренней системы. Для обычного общения в grok.com API не нужен.
Самая частая ошибка — купить SuperGrok и ожидать, что эта подписка даст бесплатные API-вызовы. Потребительская подписка и API-биллинг — отдельные продукты.
Как получить доступ
- Откройте консоль xAI.
- Создайте команду или используйте существующую.
- Настройте биллинг и лимиты расходов.
- Создайте API key.
- Храните ключ на сервере или в переменных окружения, а не в клиентском JavaScript.
Первый запрос к Grok API
После создания ключа сохраните его в переменной окружения XAI_API_KEY. Для первого теста достаточно минимального запроса через Responses API:
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-d '{
"model": "grok-4.7",
"input": "Объясни разницу между REST и GraphQL в пяти пунктах"
}'
Если запрос вернул ответ, базовая связка уже работает. После этого добавляйте историю диалога, инструменты и обработку ошибок. API key нельзя помещать в HTML страницы, клиентский JavaScript, мобильное приложение или публичный репозиторий.
Какую модель выбрать
На момент проверки основной универсальный API-моделью xAI называет Grok 4.7. Она предназначена для текста, кода, tool calling и reasoning. Для изображений, видео и голоса используются специализированные Imagine и Voice API.
Не привязывайте архитектуру приложения к одному номеру модели без необходимости. Если стабильность версии не критична, удобнее использовать актуальный алиас; если важна воспроизводимость — фиксированную версию.
\n
Если сначала нужно понять возможности генерации без кода, смотрите практический разбор Grok Imagine; API нужен уже для автоматизации этого процесса.
Сколько стоит Grok API
Для Grok 4.7 официальная цена на момент проверки составляет $2 за 1 млн входных токенов и $6 за 1 млн выходных токенов. Изображения, видео, Voice и инструменты имеют отдельную тарификацию.
Итоговая стоимость запроса складывается не только из текста ответа. В ней могут участвовать длинный контекст, reasoning, web search, X search, code execution и другие инструменты.
Минимальная архитектура
Для сайта или приложения безопасная схема выглядит так:
- пользователь отправляет запрос вашему серверу;
- сервер проверяет права и ограничения;
- сервер вызывает xAI API с ключом;
- ответ проходит нужную фильтрацию и логирование;
- пользователь получает результат.
Не помещайте секретный API key прямо в страницу сайта или мобильное приложение.
Responses API или старый Chat Completions
Для новых интеграций логичнее смотреть в сторону Responses API: xAI развивает его вместе с серверными инструментами и агентными возможностями. Старый формат может быть удобен для совместимости, но новые функции обычно проще использовать через современный API.
Web Search и X Search
Без поискового инструмента модель не получает свежие события автоматически. Если нужны актуальные данные, подключайте Web Search или X Search.
Это особенно важно для цен, новостей, рынка, публикаций и трендов. X Search умеет искать публикации, пользователей и треды, а Web Search — обычный интернет и страницы.
Пользовательский вариант поиска без программирования разобран отдельно: поиск в Grok.
Как примерно посчитать стоимость
Если запрос содержит 10 000 входных токенов, а ответ — 2 000 выходных, при цене $2 за 1 млн входных и $6 за 1 млн выходных токенов текстовая часть будет стоить примерно $0,032: около $0,02 за вход и $0,012 за выход.
Это не всегда полный чек. Web Search, X Search, code execution, длинный reasoning и другие инструменты могут тарифицироваться отдельно. Поэтому в рабочем приложении лучше логировать фактическую стоимость каждого вызова, а не оценивать расходы только по длине ответа.
Если сначала нужно понять стоимость обычной подписки, смотрите тарифы Grok: подписка и API оплачиваются отдельно.
Как контролировать расходы
- установите бюджет и внутренние лимиты;
- не отправляйте всю историю чата, если она не нужна;
- используйте кэширование там, где оно поддерживается;
- ограничивайте число шагов агентного поиска;
- разделяйте дешёвые и тяжёлые задачи;
- логируйте стоимость по функции или пользователю.
Когда API не нужен
Если сотруднику нужно просто общаться с Grok, анализировать файлы или искать информацию, API усложнит задачу. Для таких случаев подходят обычные или корпоративные подписки. Сравнение для команд — в статье Grok Business и Enterprise.
Коротко
Grok API — это отдельный продукт для интеграций. Начните с минимального серверного вызова, сразу настройте контроль расходов и добавляйте Web Search, X Search, Imagine или Voice только там, где они реально нужны.
