Groq через OpenAI-совместимый клиент: ключ, адрес API и ошибка 400

[cybercobra]

Для подключения Groq через библиотеку OpenAI нужны ключ Groq и адрес API Groq. Знакомое имя библиотеки не означает, что запрос уйдёт в OpenAI: получателя определяет настройка base_url.

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

Какой адрес указывать​

В официальной инструкции Groq для base_url указан:

https://api.groq.com/openai/v1

В api_key передаётся именно ключ Groq. Название переменной в примере — GROQ_API_KEY; это место для секрета в среде исполнения, а не значение, которое следует публиковать.

Если программа просит полный endpoint Chat Completions, это другое поле:

https://api.groq.com/openai/v1/chat/completions

Не добавляйте окончание дважды. Сначала выясните, ожидает ли клиент базовый адрес или адрес конкретной операции.

Почему правильный адрес ещё не гарантирует ответ​

Отдельно выбирается идентификатор модели у провайдера. Он не определяется названием SDK. При переносе настройки сохраняйте связку: провайдер, адрес, ключ, модель, используемый интерфейс.

Не отправляйте ключ OpenAI на чужой endpoint ради проверки. Не включайте ключи в снимки экрана, команды для публикации и журналы ошибок. Для диагностики обычно достаточно адреса без секретов, имени модели и обезличенного текста ошибки.

Какие несовместимости перечисляет Groq​

Страница совместимости предупреждает об ошибке 400 для неподдерживаемых полей logprobs, logit_bias, top_logprobs и messages[].name; если передан n, он должен равняться 1.

У Groq есть и поддержка Responses API, поэтому утверждение «работает только Chat Completions» уже неверно. Но наличие второго интерфейса не доказывает совместимость любого приложения без изменений.

Как разбирать ошибку после включения инструментов​

Сравните два запроса: минимальный текстовый и тот, где добавлены tools. Уберите из сравнения секреты, но сохраните названия полей и структуру схемы.

Полезная последовательность:

1. Зафиксировать интерфейс, модель и полный ответ об ошибке.
2. Проверить допустимость дополнительных параметров по документации.
3. Проверить схему каждого инструмента, включая properties и required.
4. Оставить один простой инструмент только на чтение.
5. Возвращать остальные возможности по очереди.

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

Что проверить после первого успешного ответа​

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

Это инструкция по настройке и диагностике, а не отчёт о тестировании. Ключи не создавались, платные запросы не выполнялись. Параметры и ограничения сверены с официальной страницей совместимости Groq.