Как создать API-ключ Grok и альтернативный ключ

Создание ключа через провайдера

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

1. Войдите в консоль разработчика провайдера с помощью своей учётной записи.
2. Проверьте раздел биллинга. Некоторые провайдеры требуют способ оплаты или депозит, прежде чем ключ заработает; прочтите, что требуется в вашем случае.
3. Откройте раздел API-ключей и выберите создание нового ключа.
4. Дайте ему имя, указывающее, где он будет использоваться, например, проект или окружение.
5. Скопируйте ключ сразу. Многие консоли показывают полный секрет только один раз.
6. Сохраните его в менеджере секретов или переменной окружения, никогда не храните в исходном коде.

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

Получение ключа здесь за минуту

Наш ключ предназначен для OpenAI-совместимого эндпоинта, обслуживающего одну размещённую модель с открытыми весами, настроенную на ответы без отказов по контенту для законного использования взрослыми. Получение занимает пять шагов.

1. Откройте страницу API-ключа.
2. Зарегистрируйтесь через Google или с помощью электронной почты и пароля.
3. Нажмите один раз, чтобы получить $0,50 пробного кредита. Он предоставляется один раз на человека, действует 7 дней и не требует привязки карты.
4. Скопируйте ключ, показанный на странице.
5. Выполните тестовый запрос ниже.

Базовый URL — https://api.grokaiapikey.com/v1, идентификатор модели — uncensored, а ключ передаётся в заголовке Authorization: Bearer.

Протестируйте ключ

Начните с curl. Если этот запрос возвращает JSON-ответ, ваш ключ, базовый URL и модель указаны верно.

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

В Node.js официальный пакет OpenAI работает после изменения двух настроек.

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.grokaiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

Пользователи Python могут сделать то же самое с OpenAI(base_url=..., api_key=...). Доступные методы — POST /v1/chat/completions, POST /v1/responses и GET /v1/models.

Установка ключа как переменной окружения

Никогда не вставляйте ключ в исходный код. Поместите его в переменную окружения и считывайте во время выполнения. Команды различаются в зависимости от системы.

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

Для проекта сохраните значение в файле .env, который указан в .gitignore, и прочитайте его с помощью загрузчика вашего фреймворка. На сервере используйте хранилище секретов хоста или настройки окружения платформы развертывания. Базовый URL для этого сайта — https://api.grokaiapikey.com/v1, и его безопасно хранить в коде, так как это не секрет.

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

Если вызов завершается ошибкой

Симптом	Вероятная причина	Исправление
401 Unauthorized	Отсутствующий или неправильно набранный ключ	Проверьте заголовок Bearer и наличие пробела или кавычки в конце
404 Not Found	Неверный базовый URL	Путь должен быть /v1/chat/completions на поддомене api
Ошибка модели	Неверное имя модели	Используйте идентификатор модели uncensored
429 rate_limited	Слишком много запросов в минуту	Пробные ключи позволяют 60 запросов в минуту; замедлите темп
429 concurrency	Слишком много одновременно	Пробные ключи позволяют 2 одновременных запроса; потоковая передача занимает слот до завершения

Ошибка 429 с заголовком Retry-After: 5 означает временную перегрузку. Подождите пять секунд и повторите запрос.

Используйте идентификатор запроса

Каждый ответ включает заголовок X-Request-Id. Логируйте его рядом с вашим сообщением об ошибке. Если вы спросите команду поддержки о неудачном запросе, идентификатор запроса позволит им найти именно этот запрос, а не гадать. В curl добавьте -i для вывода заголовков ответа, а в SDK Python вы можете прочитать их с помощью вспомогательной функции raw-response.

Когда проблема возникает периодически, заголовки также помогают: X-RateLimit-Limit-Requests и X-RateLimit-Limit-Concurrency показывают лимиты, применимые к вашему ключу, что позволяет сразу понять, используете ли вы пробный или полный ключ.

Замена или добавление ключей

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

Аккаунты с пополненным балансом могут хранить до 5 ключей. Присвойте каждому метку, например staging или mobile app, и отзовите любой ключ, не затрагивая остальные. Привычка использовать один ключ на среду полезна: отзыв скомпрометированного тестового ключа не повлияет на ваш продакшн-трафик.

Использование ключа в существующих инструментах

Вам не нужно писать код для использования ключа. Многие чат-интерфейсы и инструменты разработчиков принимают пользовательский эндпоинт, совместимый с OpenAI, и SillyTavern — один из публичных примеров. Настройка всегда запрашивает те же три значения.

• Базовый URL или URL API: https://api.grokaiapikey.com/v1
• API-ключ: скопированный вами ключ
• Имя модели: uncensored

Некоторые инструменты требуют полный путь, заканчивающийся на /chat/completions; другие добавляют его сами. Если вы получаете 404, попробуйте другой вариант. Если в инструменте есть выпадающий список моделей, который остаётся пустым, введите имя модели вручную или позвольте ему получить список из GET /v1/models, который возвращает единственный идентификатор модели.

Потоковая передача работает через те же настройки. Если ответы выводятся сразу целиком, а не по словам, найдите переключатель потоковой передачи в инструменте.

Безопасное хранение ключа

• Храните его на стороне сервера. Ключ, помещённый в JavaScript браузера или в пакет мобильного приложения, может быть прочитан кем угодно.
• Загружайте его из переменной окружения и добавьте файл .env в .gitignore перед первым коммитом.
• Установите привычку контролировать расходы: следите за заголовком ответа X-Balance-USD, чтобы неожиданное снижение баланса сразу бросалось в глаза.
• Используйте отдельные ключи для разных сервисов, чтобы можно было отозвать один без простоя в других сервисах.

Когда тестовый вызов сработает, прочитайте документацию по потоковой передаче, вызову функций и JSON-режиму, а также ознакомьтесь со страницей с ценами: $0,15 за 1 млн входных токенов и $0,50 за 1 млн выходных токенов. Если вы сравниваете это с закрытым провайдером, наша статья о причинах перехода разработчиков на модели без цензуры описывает компромиссы.

Простая процедура ротации

1. На странице API-ключей создайте или сгенерируйте заново ключ, который хотите заменить. При повторной генерации старый ключ перестаёт работать сразу, поэтому делайте это, когда ваш код уже готов принять новое значение.
2. Обновите переменную окружения или секрет в каждом месте, где используется ключ.
3. Перезапустите сервис и выполните тест curl из этой статьи.
4. Запишите дату в свои заметки. Календарного напоминания раз в несколько месяцев достаточно для большинства проектов.

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

Дополнительные руководства

• Бесплатный API-ключ Grok: что реально, а что мошенничество
• API-ключ Claude: почему разработчики переходят на модели без цензуры