Документация для разработчиков публикуется на английском. Боковое меню переведено на выбранный язык.

Поддержка и оплата

Как работают кредиты, лимиты и ошибки — и как перейти на Pro.

Кредиты и оплата

  • ✅ Только HTTP 200: 1 кредит за успешный запрос (платные эндпоинты).
  • ❌ Ошибки 4xx / 5xx: никогда не списываются — смело повторяйте.
  • ❌ Ограничение (429): никогда не списывается.
  • ✅ Бесплатные эндпоинты: /v1/verify, /v1/youtube/channel/resolve, /v1/youtube/channel/latest, GET /v1/youtube/asr/{task_id} (опрос), все чтения /v1/library.
  • 📦 Постраничные эндпоинты: 1 кредит за страницу (видео каналов, плейлисты).

Тарифы: Free 1 000 кредитов · Pro 10 000 кредитов/мес · См. цены.

Лимиты

Каждый API-ключ ограничен 200 запросами в минуту. Каждый ответ содержит заголовки лимитов:

ЗаголовокОписание
X-RateLimit-LimitВсего разрешено в минуту (200)
X-RateLimit-RemainingЗапросов осталось в текущем окне
X-RateLimit-ResetUnix-время сброса окна

При превышении API возвращает 429 с заголовком Retry-After (в секундах).

Коды ошибок

СтатусЗначениеСписывается
200УспехДа (платные эндпоинты)
400Некорректный запрос / нет параметровНет
401Недействительный или отсутствующий API-ключНет
402Кредиты закончилисьНет
404Видео / канал / субтитры не найденыНет
429Превышен лимитНет
500Внутренняя ошибка сервераНет

Тела ответов с ошибками

401 Unauthorized

{ "error": { "code": "UNAUTHORIZED", "message": "Invalid or missing API key" } }

402 Кредиты закончились

{ "error": { "code": "CREDITS_EXHAUSTED", "message": "You've run out of credits. Upgrade or top up." } }

404 Не найдено (нет субтитров)

{ "error": { "code": "NO_CAPTIONS", "message": "No captions available for this video" } }

429 Лимит превышен

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// Ответ также содержит заголовок:  Retry-After: 12

Поддержка