Прежде чем проектировать интеграцию с AI-сервисом — разбираемся с его API-документацией.
Без этого разработанные требования могут оказаться нереализуемыми.
Разбираем Groq API для проекта #MedAssistGA👇
✅ Документация
Главная страница
API Reference - основная документация для интеграции по API
✅ Вид API
REST API (JSON)
Поддерживается стриминг через SSE (Server-Sent Events)
✅ Авторизация и аутентификация
API Key
Передаётся в заголовке запроса:
Authorization: Bearer {api_key}
Ключ генерируется в консоли: console.groq.com/keys
✅ Тестовые доступы
✔ Есть бесплатный лимит запросов без привязки карты.
✔ Доступны все модели, ограничение только по rate limits
✅ Рекомендации по использованию
✔ Quickstart — как начать работать
✔ Prompting Guide — базовые и продвинутые рекомендации по разработке промптов
✔ Cookbooks — примеры использования
✔ Tool Use — поможет для разработки сценариев "AI вызывает медсистему"
✔ Production Checklist — отдельный раздел по подготовке системы к продакшн, включая безопасность
✅ Ограничения и особенности
✔ Rate limits по трём измерениям одновременно:
RPM — запросов в минуту
TPM — токенов в минуту
RPD — запросов в день
✔ Лимиты применяются на уровне организации (не пользователя)
✔ Срабатывает первый достигнутый лимит — не обязательно по токенам
✔ Кэшированные токены не учитываются в лимитах (актуально для системного промпта)
✔ Проверка лимитов аккаунта по ссылке
✅ Общие требования к обработке ошибок
Стандартные HTTP-коды, подробно описаны в разделе Error Codes.
При превышении rate limit (HTTP-429), в ответе заголовок retry-after — указывает, через сколько секунд повторить запрос.
✅ Список методов для нашей задачи
POST /chat/completions — основной метод диалога с ИИ (текстовый ответ)
✔ stream: true — стриминг ответа через SSE
✔ Tool Use (Local Tool Calling) — механизм вызова AI-агентом инструментов нашей системы: расписание, список врачей, запись, уведомления
👉 Других методов для сценария записи к врачу не потребуется.
Результат этого первичного анализа — основа для исследовательского тестирования API в Postman и постановки задач разработчикам 📝✅
#ИнтеграцииGA
📱 GetAnalyst | 💙 VK | 💬 Max