Youtube-Transcript-API

Почему YouTubeTranscript.dev?

Большинство инструментов для работы с субтитрами YouTube ломаются, когда у видео нет субтитров. Наш — нет. API извлекает существующие субтитры и транскрибирует напрямую из аудио с помощью AI-распознавания речи — охватывая 100% видео на YouTube.

• ⚡ Молниеносная скорость — кэшированные транскрипты возвращаются менее чем за 2 секунды
• 🎙 Аудиотранскрипция (ASR) — нет субтитров? Транскрибируем из аудиодорожки
• 🌍 100+ языков — мультиязычная поддержка с переводом по запросу
• 📤 Несколько форматов — временны́е метки, абзацы, пословный вывод
• 📚 Пакетная обработка — до 100 видео за один запрос
• 🔔 Вебхуки — асинхронная обработка с доставкой на ваш эндпоинт
• 💰 Предсказуемые тарифы — 1 кредит за транскрипт, никаких сюрпризов
• 🔒 Готово для продакшена — SLA с аптаймом 99.9%

→ Получить бесплатный API-ключ

Обзор API V2

V2 — это упрощённая модель транскриптов, принадлежащих пользователю. Приоритет отдаётся быстрым попаданиям в кэш, согласованным ответам и отсутствию неожиданных переводов, если вы явно не запросили конкретный язык.

Как работает V2

1. Проверка ваших транскриптов (0 кредитов) — если вы уже получали транскрипт, он бесплатен
2. Получение субтитров (1 кредит) — если транскрипт ещё не получен
3. Перевод (1 кредит за 2 500 символов) — только при явном запросе конкретного языка
4. ASR-транскрипция (1 кредит за 90 секунд) — асинхронно через вебхук, для видео без субтитров

Эндпоинты

Стоимость в кредитах

Быстрый старт

1. Получите API-ключ

Зарегистрируйтесь на youtubetranscript.dev и получите API-ключ в Dashboard.

2. Извлечение транскрипта

curl -X POST https://youtubetranscript.dev/api/v2/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

3. С параметрами

curl -X POST https://youtubetranscript.dev/api/v2/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "dQw4w9WgXcQ",
    "language": "es",
    "format": "timestamp"
  }'

4. Пакетный запрос (до 100 видео)

curl -X POST https://youtubetranscript.dev/api/v2/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_ids": [
      "dQw4w9WgXcQ",
      "https://www.youtube.com/watch?v=VIDEO_ID_2",
      "VIDEO_ID_3"
    ]
  }'

5. ASR с вебхуком (видео без субтитров)

curl -X POST https://youtubetranscript.dev/api/v2/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "VIDEO_ID",
    "source": "asr",
    "webhook_url": "https://yoursite.com/webhook"
  }'

Возвращает ответ немедленно со статусом status: "processing". Результаты доставляются на вебхук по готовности.

Справочник запросов

Заголовки

Поля запроса

Поведение вебхуков

• Запросы с webhook_url возвращают ответ немедленно со статусом status: "processing"
• Пакетные запросы немедленно возвращают кэшированные результаты и ставят в очередь только отсутствующие элементы