Groq API: ключ, бесплатный уровень, лимиты и что доступно из России

Groq — быстрый вывод открытых моделей через OpenAI-совместимый API с бесплатным уровнем. Разбираем ключ, адрес, лимиты и что из этого работает из России.

Получить ключ Что делать

/ Короткий ответ

Что это значит

Groq API — доступ к открытым моделям (Llama, gpt-oss, Qwen) на собственных чипах Groq через сервис GroqCloud. Формат совместим с OpenAI: адрес https://api.groq.com/openai/v1, тот же SDK, те же поля и тот же вид ошибок. Ключ создаётся в консоли GroqCloud после регистрации, контекст у моделей до 131 тысяч токенов.

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

С Россией всё неоднозначно. Официального списка закрытых стран Groq не публикует. На момент написания регистрация проходит не у всех, а оплата платного плана с картой РФ не проходит. Закрытых моделей — GPT, Claude, Gemini — у Groq нет: если нужны они, это другой сервис.

/ Почему

Откуда берётся ошибка

401 Invalid API Key. Ключ скопирован не полностью, отозван в консоли или подставлен ключ от другого сервиса.
429 на бесплатном уровне. Лимит запросов или токенов в минуту по конкретной модели исчерпан; это самая частая ошибка у Groq.
404 model not found. Имя модели устарело: Groq регулярно снимает модели с обслуживания, актуальный список — в консоли.
400 по длине контекста. Запрос больше окна модели или больше лимита токенов на запрос для вашего уровня.
403 или отказ при регистрации. Аккаунт ограничен, в том числе по региону; официальных критериев Groq не публикует.

/ Тексты ошибок

Ошибки Groq API: текст, причина, что делать

Текст ошибки	Причина	Что делать
401 Invalid API Key	Ключ не принят	Создать новый ключ в консоли GroqCloud, проверить заголовок Authorization: Bearer
429 Rate limit reached for model	Лимит бесплатного или платного уровня по этой модели	Ждать по Retry-After, сократить запросы, другая модель или платный план
404 The model does not exist or you do not have access to it	Устаревшее или неверное имя модели	Взять имя из актуального списка моделей в консоли
400 Please reduce the length of the messages or completion	Контекст больше окна модели или лимита на запрос	Сократить историю, уменьшить max_tokens
403 Forbidden	Аккаунт или ключ ограничен, в том числе по региону	Проверить статус аккаунта в консоли; ключом не чинится

Формат тела ошибки как у OpenAI: объект error с полями message, type и code. Тексты приведены на момент написания.

/ Что делать

Порядок действий

Создайте ключ в консоли GroqCloud

Раздел API Keys, кнопка создания, ключ показывается один раз. Сохраните его в переменную окружения, а не в код.

Проверьте ключ и список моделей

Если пришёл список — ключ и адрес верны. 401 значит проблема в ключе, 403 — в аккаунте.

curl https://api.groq.com/openai/v1/models \
  -H "Authorization: Bearer $GROQ_API_KEY"

Подключите через OpenAI SDK

Никакой отдельной библиотеки не нужно: тот же клиент, другой base_url и имя модели из списка.

from openai import OpenAI
client = OpenAI(
    api_key="gsk_...",
    base_url="https://api.groq.com/openai/v1",
    max_retries=3,
)

Обработайте 429

На бесплатном уровне это норма. Уважайте заголовок Retry-After, не запускайте параллельные потоки и не делите один ключ между несколькими сервисами.

Решите, что делать с лимитами

Для прототипа бесплатного уровня хватит. Для продакшена нужен платный план с зарубежной картой или другой сервис с теми же открытыми моделями.

/ По инструментам

Где это чинится в разных инструментах

Python и Node.js SDK OpenAI. base_url https://api.groq.com/openai/v1 и ключ. Исключения RateLimitError для 429 и NotFoundError для устаревшей модели.
Cline, Continue. Провайдер OpenAI Compatible: Base URL, API Key, Model ID из списка Groq. На бесплатном уровне агент быстро упирается в 429: у него много запросов подряд.
Open WebUI. Settings → Connections, адрес с /openai/v1 и ключ. Без /openai/v1 список моделей будет пустым.
n8n. Есть отдельная нода Groq Chat Model; при 429 включите Retry On Fail с паузой по Retry-After.

/ FAQ

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

Бесплатный уровень Groq — это навсегда?

На момент написания он есть, но лимиты и список моделей Groq меняет без предупреждения. Для прототипа — да, для продакшена рассчитывать на него не стоит.

Можно ли через Groq вызвать GPT или Claude?

Нет. Groq обслуживает только открытые модели: Llama, gpt-oss, Qwen и подобные.

Работает ли Groq из России без VPN?

Официального ответа нет. У части пользователей регистрация проходит, у части нет; оплата картой РФ не проходит. Проверяйте на своём аккаунте, не рассчитывайте заранее.

/ На kosareva.cloud

Как это выглядит у нас

Groq-моделей у нас нет, и скорость Groq мы не обещаем. Из открытых моделей у нас Qwen, DeepSeek, GLM, Kimi, MiniMax и Mistral по тому же OpenAI-совместимому адресу: Qwen3.8 Flash — 15,12 ₽ за миллион токенов на входе и 45,36 ₽ на выходе, DeepSeek V4 Flash — 47,52 и 142,56 ₽, Qwen3.6 35B-A3B, размещённая в России, — 14 и 42 ₽. Оплата картой РФ или СБП от 50 ₽, запросы без VPN.

/ Дальше

Рядом в справочнике

Ключ, который работает из России

OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.

Получить ключ