Статус API
Как проверить, что QuillAI API работает, как мы сообщаем об инцидентах и что стоит мониторить на своей стороне во время беты.
Проверка доступности
Отдельного /health-эндпоинта пока нет. Самый дешёвый способ убедиться, что API-шлюз и слой авторизации работают — вызвать GET /v1/me: тот же запрос использует и дашборд.
curl -I https://api.quillhub.ai/v1/me \
-H "Authorization: Bearer $QAI_KEY"200 OK — всё в порядке. 401 означает, что ключ невалиден (это не авария). 5xx — проблема на нашей стороне; прежде чем ретраить, загляните в канал оповещений.
Что значит «работает»
QuillAI состоит из нескольких частей. Когда мы говорим, что API работает, имеется в виду, что все они здоровы:
- API-шлюз — Принимает запросы на api.quillhub.ai, проверяет ключи и ставит задачи в очередь.
- Воркеры транскрибации — Забирают задачи из очереди, вызывают внешнего провайдера и записывают результаты.
- Хранилище — S3-совместимое объектное хранилище для загруженного аудио и сгенерированных субтитров.
- Биллинг — Списывает поинты при завершении и блокирует новые задачи, когда баланс исчерпан.
Известные деградации
Во время беты публичной ленты инцидентов пока нет. Когда что-то ломается, мы связываемся с вами через два канала:
- Email владельцу аккаунта — по всему, что касается данных или биллинга.
- Telegram-канал @quillai_status с оперативными обновлениями (плейсхолдер — канал может быть ещё не запущен; мы пришлём ссылку письмом, когда он откроется).
Целевой аптайм
Формального SLA на время беты нет. Мы целимся в 99.5% в месяц и ожидаем деградированные режимы на старте — пока масштабируем воркеры и настраиваем пайплайн. После выхода из беты опубликуем обязательный SLA и выложим исторические данные по аптайму.
Сообщить о проблеме
Если запрос упал и вы считаете, что это наша вина, возьмите request_id из тела ответа и отправьте на [email protected]. Так мы быстрее всего найдём, что случилось — по request_id видно весь путь запроса в логах. См. Ошибки.
Мониторинг на вашей стороне
- Направьте простой uptime-чек (BetterStack, Pingdom, UptimeRobot — любой) на GET /v1/me раз в минуту с тестовым ключом.
- Алертите только после 3 подряд 5xx — одиночные всплески случаются при деплоях и не стоят пейджера.
- Никогда не алертите на 4xx — это ошибки клиента (плохой ключ, кривое тело), они всегда на вашей стороне.
В планах
Позже в бете запустим публичную страницу status.quillhub.ai с историей аптайма по компонентам и кнопкой подписки, а также опциональный вебхук на смену статуса компонента — чтобы вы могли завести его в свою инцидент-систему.