Гайды

Groq API key: как получить и лимиты бесплатного плана

10 сентября 2026 · 15 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Числа сняты со страниц GroqCloud 10 сентября 2026 года, ответы API проверены собственным прогоном. Обновлено: сентябрь 2026.

Groq API key выдаётся бесплатно и без карты в консоли console.groq.com/keys: вход, раздел API Keys, кнопка Create API Key, значение показывается один раз. Бесплатный план открывает 13 моделей — GPT-OSS, Qwen, Whisper, Compound, Prompt Guard и Orpheus — с потолком 30 запросов в минуту и 1000 в сутки у самых ходовых. Квота считается на организацию целиком, поэтому второй ключ второй квоты не даёт.

Главное:

• Таблица Free Plan Limits в документации Groq содержит ровно 13 идентификаторов моделей.
• У openai/gpt-oss-120b бесплатный потолок — 30 RPM, 1000 RPD, 8 000 TPM и 200 000 TPD.
• Моделей Llama в этой таблице нет: в каталоге Groq у них стоит метка Enterprise и «Contact Sales».
• На любой негодный ключ Groq отвечает одинаково: HTTP 401 и код invalid_api_key.
• Лимит расхода и режимы Batch и Flex открываются только на платном плане Developer.

Как получить Groq API key в консоли GroqCloud

Ключ живёт в консоли console.groq.com, витрина groq.com ключей не выдаёт. Quickstart вендора первым шагом называет «Create an API Key» и добавляет: «Please visit here to create an API Key» — ссылка ведёт на console.groq.com/keys. Вход идёт через Google, GitHub или почту, платёжный метод на этом шаге не спрашивают: карта нужна только для платного плана.

Два ограничения консоли стоит знать заранее. Первое — роль: страница ключей GroqCloud предупреждает, что «Only team owners or users with the developer role may create or manage API keys», и участник с ролью Reader кнопки создания не увидит. Второе — проект: документация Groq говорит, что «Any API keys generated will be specific to the project you have selected», а логи и лимиты у проекта свои.

Список ключей показывает пять колонок: Name, Secret Key, Created, Last Used и Usage (24hrs) — последние две говорят, какой ключ ещё работает и сколько съедает за сутки.

Хранить ключ Groq советует в переменной окружения. Формулировка quickstart: export GROQ_API_KEY=<your-api-key-here>, потому что это «enhances security by minimizing the risk of inadvertently including your API key in your codebase». Ту же логику разбирали ключ Claude Code API и агрегатор OpenRouter.

Мини-вывод: Groq API key создаётся за минуту, но принадлежит проекту и роли, поэтому в командном аккаунте кнопка есть не у всех.

Что открывает бесплатный Groq API key: таблица лимитов

Страница Rate Limits в документации Groq держит вкладку Free Plan Limits, и в ней ровно 13 строк. Вот они целиком на 10 сентября 2026 года.

Сокращения оттуда же: RPM — запросы в минуту, RPD — в сутки, TPM — токены в минуту, TPD — в сутки, ASH и ASD — секунды аудио в час и в сутки. Groq добавляет два правила, которые меняют арифметику: «Rate limits apply at the organization level, not individual users» и «Cached tokens do not count towards your rate limits». При превышении Groq отдаёт код 429 Too Many Requests и заголовок retry-after в секундах; заголовки x-ratelimit-limit-requests (это RPD) и x-ratelimit-limit-tokens (это TPM) вендор обещает во всех остальных ответах.

Что из этих чисел следует, но нигде не написано. Окно контекста у openai/gpt-oss-120b в каталоге Groq — 131 072 токена, а минутный потолок бесплатного плана — 8 000. Один запрос на всё окно в минутную квоту не влезает физически. Суточные 200 000 токенов при 8 000 в минуту дают 25 минут работы на полной скорости за сутки, а 1000 запросов при 30 в минуту — 33 минуты. Бесплатный план Groq — уровень прототипа, и числа говорят об этом прямее маркетинга.

Мини-вывод: бесплатный Groq API key ограничен четырьмя счётчиками сразу, и срабатывает тот, до которого вы дойдёте первым.

Почему списки бесплатных моделей Groq расходятся с каталогом

Три страницы из топ-10 Яндекса по запросам про Groq API key живут перечислением бесплатных моделей, и все три расходятся с каталогом вендора. Сайт freellm.net с пометкой «Last Updated 2026-09-10» обещает «7 free models online», включает в список moonshotai/kimi-k2-instruct и советует: «Llama 3.3 70B is the most popular free option». Сайт free-model.com обещает «14 free models available» и «Free tier: 14,400 RPD for most models». Статья на vc.ru от 24 июля 2026 года приводит для Llama 3.1 8B Instant лимиты 30 RPM, 14 400 RPD, 6 000 TPM и 500 000 TPD.

Каталог Groq на ту же дату говорит другое: модели Kimi K2 в нём нет вообще. У llama-3.1-8b-instant и llama-3.3-70b-versatile стоит метка Enterprise, а в колонках цены и лимитов — «Contact Sales»; в таблице Free Plan Limits их нет. Значение 14.4K RPD в бесплатной таблице стоит ровно у двух моделей-фильтров Llama Prompt Guard 2.

Ловушка, из-за которой чужие таблицы разъезжаются, видна в самом каталоге: колонка лимитов там озаглавлена «RATE LIMITS (DEVELOPER PLAN)» — это платный план. Числа из неё перепечатывают как бесплатные, и получается таблица, которой не соответствует ни один бесплатный ключ.

Проверять состав лучше машинно: Groq отдаёт список моделей конкретного ключа обычным GET-запросом:

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

Ответ — JSON со списком активных моделей вашей организации. Этот источник не устаревает: он отвечает про ваш ключ.

Мини-вывод: сверяйте список моделей Groq эндпоинтом /models — подборки «free API keys» отстают от каталога вендора на месяцы.

Первый запрос с Groq API key: рабочий код

Самая короткая проверка ключа — одна команда в терминале, с моделью из бесплатной таблицы:

curl https://api.groq.com/openai/v1/chat/completions -s \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GROQ_API_KEY" \
-d '{
  "model": "openai/gpt-oss-20b",
  "messages": [{"role": "user", "content": "Ответь одним словом: работает"}]
}'

Второй путь — из кода, через библиотеку groq. Quickstart показывает такую форму:

import os
from groq import Groq

client = Groq(api_key=os.environ["GROQ_API_KEY"])

resp = client.chat.completions.create(
    model="openai/gpt-oss-20b",
    messages=[{"role": "user", "content": "Ответь одним словом: работает"}],
)
print(resp.choices[0].message.content)

Третий путь — совместимость с OpenAI: «pass your Groq API key to the api_key parameter and change the base_url to https://api.groq.com/openai/v1». Любой клиент, умеющий OpenAI-совместимый адрес, подключается к Groq заменой двух строк.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GROQ_API_KEY"],
    base_url="https://api.groq.com/openai/v1",
)

Пробелы совместимости вендор перечисляет сам, и один опасен молчанием. Поля logprobs, logit_bias, top_logprobs и messages[].name дают ошибку 400; параметр n обязан равняться единице; а temperature со значением 0 «will be converted to 1e-8» — тихо, без предупреждения. Расчёт на детерминированный ответ при нулевой температуре здесь не сработает.

Мини-вывод: Groq API key подставляется в готовый OpenAI-клиент без переписывания кода, но четыре привычных параметра придётся выбросить.

Что отвечает API на неверный Groq API key: наш прогон

Ни одна страница топ-10 не показывает, что приходит в ответ на плохой ключ. Мы сняли это сами: скрипт groq_key_probe.py написан редакцией Зерокодера, зависимостей нет.

# groq_key_probe.py - проверка ключа GroqCloud до того, как он попал в приложение.
# Четыре вопроса: жив ли ключ, какие модели он открывает, какие лимиты стоят
# у организации и что реально лежит в теле ошибки. Только стандартная библиотека.
import os, sys, json, time, urllib.request, urllib.error
sys.stdout.reconfigure(encoding="utf-8")

KEY = os.environ.get("GROQ_API_KEY") or (sys.argv[1] if len(sys.argv) > 1 else "")
BASE = "https://api.groq.com/openai/v1"
MODEL = os.environ.get("GROQ_MODEL", "openai/gpt-oss-20b")
# User-Agent задаём руками. Без него Python подставляет "Python-urllib/3.x",
# и запрос отбивает Cloudflare - HTTP 403 с телом "error code: 1010".
# Это ответ не Groq и не про ключ, но выглядит один в один как блокировка.
UA = "groq-key-probe/1.0 (+zerocoder)"


def call(path, payload=None):
    """(код, тело, заголовки, секунды). Тело читаем всегда: диагноз лежит в нём."""
    req = urllib.request.Request(
        BASE + path,
        data=json.dumps(payload).encode() if payload else None,
        headers={"Authorization": "Bearer " + KEY,
                 "Content-Type": "application/json",
                 "User-Agent": UA},
        method="POST" if payload else "GET")
    t0 = time.perf_counter()
    try:
        r = urllib.request.urlopen(req, timeout=60)
        return r.status, r.read().decode("utf-8", "replace"), dict(r.headers), time.perf_counter() - t0
    except urllib.error.HTTPError as e:
        return e.code, e.read().decode("utf-8", "replace"), dict(e.headers), time.perf_counter() - t0


code, body, hdr, dt = call("/models")
print(f"1. GET /models -> HTTP {code} за {dt:.2f} c")
if code == 200:
    ids = sorted(m["id"] for m in json.loads(body)["data"])
    print(f"   ключ открывает моделей: {len(ids)}")
    for i in ids:
        print("   -", i)
else:
    print("   тело:", body.strip()[:200])

code, body, hdr, dt = call("/chat/completions", {
    "model": MODEL,
    "messages": [{"role": "user", "content": "Ответь одним словом: работает"}],
    "max_tokens": 16})
print(f"2. POST /chat/completions ({MODEL}) -> HTTP {code} за {dt:.2f} c")
print("   тело:", body.strip()[:200])

print("3. лимиты вашей организации из заголовков ответа:")
rl = [f"   {k}: {v}" for k, v in hdr.items()
      if k.lower().startswith("x-ratelimit") or k.lower() == "retry-after"]
print("\n".join(rl) if rl else "   заголовков x-ratelimit нет: запрос не дошёл до учёта лимитов")

Прогон 10 сентября 2026 года, Python 3.14.3, ключ не задан:

1. GET /models -> HTTP 401 за 0.36 c
   тело: {"error":{"message":"Invalid API Key","type":"invalid_request_error","code":"invalid_api_key"}}
2. POST /chat/completions (openai/gpt-oss-20b) -> HTTP 401 за 0.18 c
   тело: {"error":{"message":"Invalid API Key","type":"invalid_request_error","code":"invalid_api_key"}}
3. лимиты вашей организации из заголовков ответа:
   заголовков x-ratelimit нет: запрос не дошёл до учёта лимитов

Тот же прогон мы повторили на четырёх плохих ключах: заголовка Authorization нет вовсе, заголовок пустой, в нём строка-мусор, в нём правдоподобный ключ формата gsk_. Ответ совпал до символа — 401 и "code":"invalid_api_key". По тексту ошибки нельзя понять, отсутствует ключ или он просто неверный, поэтому проверять надо саму переменную окружения.

Второе наблюдение: ключ проверяется раньше имени модели. Запрос к несуществующей llama-3.3-70b-versatile-xxx с негодным ключом вернул тот же 401 invalid_api_key. Чинить надо по порядку — сначала ключ, потом идентификатор модели.

Третье наблюдение оказалось самым дорогим: тот же запрос с тем же ключом отдаёт разный код из-за одного заголовка.

User-Agent по умолчанию (Python-urllib): HTTP 403 error code: 1010
User-Agent задан явно:                   HTTP 401 {"error":{"message":"Invalid API Key", ...}}

HTTP 403 с телом «error code: 1010» — фильтр Cloudflare по подписи клиента, до Groq такой запрос не доходит. Внешне он неотличим от блокировки по стране. Разница читается в теле: у Cloudflare строка «error code: 1010», у самого Groq — JSON вида {"error":{"message":"Forbidden"}}.

Границы замера. Наша машина выходит в интернет с европейского адреса 130.17.14.168 (Fornex Hosting, Швеция, по ip-api.com). Прогон судит о поведении API по отношению к ключу и ничего не говорит о доступности Groq из российской сети — для этого запустите скрипт у себя.

Мини-вывод: groq_key_probe.py отличает мёртвый ключ от заблокированного запроса и показывает лимиты организации в заголовках ответа.

Groq API key из России: что написано у вендора

Списка поддерживаемых стран Groq не публикует: страница политик от 22 июня 2026 года перечисляет всё, от Website Terms of Use до Feedback Policy, и перечня стран среди этих документов нет. Ближайшее по смыслу правило лежит в соглашении об услугах: клиент обязуется не использовать сервис «in a manner that breaches, or causes the breach of, Export Control Laws», где под этим понимаются регламент EAR министерства торговли США, санкции OFAC и ITAR. За нарушение Groq вправе расторгнуть договор немедленно.

Второе ограничение денежное. Платёжные методы Groq перечисляет списком: «credit cards (Visa, MasterCard, American Express, Discover), United States bank accounts, and SEPA debit accounts». Российской карты в списке нет, и это отдельная от сетевого доступа история: бесплатный план платёжного метода вообще не требует.

Единственная датированная проверка с российского адреса в выдаче принадлежит vladochkaclub.ru: 18 августа 2026 года консоль console.groq.com и адрес api.groq.com с московского адреса отвечали кодом 403 и телом {"error":{"message":"Forbidden"}}, при этом витрина groq.com открывалась нормально. Мы этот замер не повторяли: своей проверки из российской сети у нас нет, поэтому приводим чужую с источником и датой. Как ведут себя в такой ситуации агрегаторы моделей, разобрано в тексте про блокировки OpenRouter.

Мини-вывод: у Groq нет опубликованного списка стран, зато есть жёсткая привязка к экспортному контролю США и платёжные методы без российских карт.

Бесплатный план Groq против Developer

Платный план у Groq один — Developer. Абонплаты нет, деньги списываются по факту расхода, но не только в конце месяца: счёт выставляется автоматически при переходе накопительных порогов в 1, 10, 100, 500 и 1000 долларов. Нижнюю границу вендор оговаривает отдельно: «We only bill you once your usage has reached at least $0.50».

Что даёт переход, Groq формулирует на странице лимитов: «Upgrade to Developer plan to access higher limits, Batch and Flex processing, and more». Сюда же попадает лимит расхода: раздел Spend Limits прямо предупреждает, что «Spending limits are only available on paid plans, not free tier accounts». Поставить потолок трат бесплатный аккаунт не может: тратить ему нечего.

Вернуться назад можно в любой момент: Groq выставит финальный счёт за неоплаченное, и «You’ll need to pay this final invoice before the downgrade is complete».

Отдельный пункт, редко попадающий в обзоры, — что происходит с содержимым запросов. Документ Your Data говорит прямо — «By default, Groq does not retain customer data for inference requests». Логи входа и выхода появляются при разборе сбоев и подозрений в злоупотреблении и живут до 30 дней. Режим Zero Data Retention доступен всем клиентам, включая бесплатных. Для сравнения: на странице цен Gemini API у строки «Used to improve our products» в колонке бесплатного уровня стоит «Да», а в колонке платного — «Нет». Подробности в разборе бесплатного Gemini.

Мини-вывод: бесплатный план Groq платит лимитами, а данные запросов на нём защищены теми же правилами, что и на платном.

Чек-лист: что проверить после выпуска ключа

• Убедитесь, что ключ выпущен в нужном проекте: логи и лимиты в GroqCloud считаются по нему.
• Положите значение в GROQ_API_KEY и уберите из кода: повторно посмотреть ключ в консоли нельзя.
• Запустите groq_key_probe.py и посмотрите, сколько моделей открывает ваш ключ по эндпоинту /models.
• Сверьте свои лимиты в заголовках x-ratelimit-* ответа: там квота вашей организации.
• Получили 403 с телом «error code: 1010» — выставьте User-Agent, к ключу этот ответ отношения не имеет.
• Планируете длинный контекст — сопоставьте 131 072 токена окна с минутным потолком в 8 000 на бесплатном плане.
• Берёте модель из чужой подборки — проверьте её в каталоге Groq на метку Enterprise и «Contact Sales».
• Считаете переход на Developer — учтите накопительные пороги списания $1, $10, $100, $500 и $1000.