API транскриптов YouTube сначала субтитры авторов, с таймингом по каждой реплике
Один эндпоинт для видео и Shorts на YouTube. Сначала берутся субтитры авторов, с таймингом по каждой реплике.
Ключевые преимущества и ограничения, которые с ними идут
Получайте субтитры авторов из видео и Shorts на YouTube как сегменты с таймкодами, а AI-расшифровку на платных тарифах для видео без субтитров.
Эксплуатационные ограничения и прозрачность
- Инфраструктура в одном регионе, развёрнута в us-east.
- Тарифы: 1 кредит за транскрипт по субтитрам и 2 кредита за каждую начатую минуту AI-расшифровки, с одного баланса.
- Максимальная длительность медиа: 2 часа (7 200 секунд) на один источник.
Запрос и ответ точный запрос и то, что приходит в ответ
POST/v1/jobs
curl -X POST https://www.transcriptdock.com/v1/jobs \-H "Authorization: Bearer td_live_..." \-H "Content-Type: application/json" \-H "Idempotency-Key: $(uuidgen)" \-d '{"source": {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},"mode": "captions_only","caption_preference": "prefer_creator"}'
Результат задачи
{"id": "7b8f9e0a-4c2d-4e6f-8a1b-3c5d7e9f1a2b","status": "succeeded","stage": null,"result_id": "9c1d3e5f-7a9b-4c2d-8e0f-1a3b5c7d9e2f","error": null,"billing": {"credits_reserved": 0,"credits_charged": 1,"kind": "captions"},"source": {"platform": "youtube","media_id": "dQw4w9WgXcQ","canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ","title": "Sample YouTube Video","upload_id": null},"options": {"mode": "captions_only","language": null,"caption_preference": "prefer_creator"},"created_at": "2026-09-12T14:32:00Z"}
Частые вопросы
Что происходит с субтитрами, AI-расшифровкой и ограничениями для этого источника.
Как API работает с видео без субтитров?
Если mode установлен в auto, система сначала проверяет субтитры автора. Если их нет, она безопасно получает аудио и запускает AI-расшифровку, чтобы создать транскрипт с таймкодами.
Можно ли запросить только субтитры, чтобы не платить за AI-расшифровку?
Да. Установка mode в captions_only гарантирует, что конвейер AI-расшифровки не запускается, что делает стоимость извлечения предсказуемой и низкой.
Поддерживаются ли YouTube Shorts?
Да. И обычные ссылки youtube.com/watch, и адреса youtube.com/shorts приводятся к единому виду и расшифровываются.