Grok API: ключи, эндпоинты, модели и первый запрос

Что такое Grok API

Grok API — платный интерфейс для разработчиков от SpaceXSI (ранее xAI). Он даёт вашему собственному коду доступ к тому же семейству моделей Grok, на котором работают приложения Grok, а также к моделям изображений, видео и голоса. Оплата — за токены, за изображение, за секунду видео или за минуту аудио.

API отделён от потребительских тарифов. На странице цен The X Subscription «Grok API access» указан в тарифе Plus, но там же сказано, что использование API оплачивается отдельно. SpaceXSI не объясняет, как одно связано с другим, так что рассчитывайте оплачивать вызовы API кредитами в консоли.

Основные сценарии — обычные: чат и рассуждения в ваших приложениях, агенты, вызывающие инструменты, понимание документов и изображений и генерация медиа. Простое определение — в статье об API в нашем глоссарии.

Как получить API-ключ Grok

Быстрый старт SpaceXSI описывает четыре шага:

1. Создайте аккаунт на console.x.ai.
2. Пополните баланс предоплаченными кредитами. В документации сказано, что без кредитов вызовы не работают.
3. Откройте страницу API Keys и создайте ключ.
4. Сохраните ключ в переменной окружения XAI_API_KEY, а не в исходном коде.

По умолчанию оплата предварительная. Когда кредиты заканчиваются, запросы отклоняются. Можно включить автопополнение — минимум $5. Оплата по счетам по умолчанию отключена, её нужно запрашивать у отдела продаж SpaceXSI.

Базовый URL, SDK и эндпоинты

Все запросы идут на базовый URL https://api.x.ai/v1. В документации указаны три способа обращения:

• xai_sdk — официальный SDK для Python.
• OpenAI SDK (Python и JavaScript), настроенный на базовый URL xAI.
• Vercel AI SDK через пакет @ai-sdk/xai.

Responses API или Chat Completions

Responses API по адресу /v1/responses — основной интерфейс SpaceXSI. Chat Completions по адресу /v1/chat/completions по-прежнему поддерживается. С Grok 4.7 вызовы Responses API всегда возвращают зашифрованные рассуждения. Устаревший эндпоинт /v1/completions заменён на /v1/chat/completions.

Эндпоинты в стиле Anthropic устарели

Совместимые с Anthropic эндпоинты /v1/messages и /v1/complete помечены как устаревшие. SpaceXSI предлагает вместо них Responses API или gRPC. Дата отключения не названа, но новые проекты на них строить не стоит.

Региональный эндпоинт в США

Эндпоинт https://us.api.x.ai/v1 выполняет инференс в США. Он стоит в 1,1 раза дороже глобальных тарифов и обслуживает только grok-4.7 и grok-4.6. Подробности — на нашей странице цен Grok API.

Минимальный первый запрос

Этот пример вызывает Responses API через curl. Предполагается, что ключ хранится в XAI_API_KEY:

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

С первого дня стоит знать две настройки:

• reasoning_effort: Grok 4.7 принимает low, medium, high (по умолчанию) или xhigh.
• prompt_cache_key (или заголовок x-grok-conv-id): SpaceXSI настоятельно рекомендует его задавать. Без него запрос может попасть на сервер с холодным кэшем и оплачиваться по полной цене за входные токены.

Названия полей могут меняться. Перед выпуском сверьтесь со справочником запросов в официальной документации.

Модели в Grok API

Текущие текстовые модели с ценами в долларах США за 1M токенов. Промпты длиннее 200k токенов стоят вдвое дороже.

Grok 4.7 Fast в публичном API нет. Она предлагается только в Cursor и Grok Build. Несколько старых моделей, включая grok-3, grok-4-0709, Grok 4 Fast и grok-code-fast-1, выведены из эксплуатации 15 мая 2026 г. Запросы к grok-code-fast-1 теперь перенаправляются на grok-build-0.1.

API также обслуживает модели изображений и видео Grok Imagine и модели Grok Voice. См. Grok Imagine и гид по Grok Voice API.

Встроенные инструменты

Модели Grok могут вызывать серверные инструменты, которые SpaceXSI запускает за вас. На странице цен перечислены:

• Web Search и Image Search.
• X Search, который возвращает посты и профили из X.
• Code Execution.
• File attachment search и Collections Search для поиска по вашим собственным документам.
• Инструменты view_image, view_x_video и Remote MCP, за которые взимается плата только за токены.

Большинство инструментов оплачиваются за каждые 1000 вызовов сверх стоимости токенов. У каждой модели также есть ограничения запросов и токенов по уровням — о них на нашей странице лимитов Grok API.

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