API прямого аудио
API расшифровки подкастов целые выпуски с таймингом слов
Публичные ссылки на аудио и MP3-файлы подкастов, до 2 часов на выпуск, через AI-расшифровку.
1.0Возможности
Ключевые преимущества и ограничения, которые с ними идут
Расшифровывайте выпуски подкастов по прямым ссылкам на аудио, включая URL из RSS enclosure, с сегментами по времени и таймингом слов.
Эксплуатационные ограничения и прозрачность
- Максимальный размер аудиофайла: 250 МБ (262 144 000 байт).
- Максимальная длительность выпуска: 7 200 секунд (2 часа).
- Инфраструктура в одном регионе. AI-расшифровка списывается по 2 кредита за каждую начатую минуту, с минимумом 60 секунд.
2.0Реализация
Запрос и ответ точный запрос и то, что приходит в ответ
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://media.example.com/podcasts/episode-104.mp3"},"mode": "transcribe"}'
Результат задачи
{"id": "8e9f0a1b-2c3d-4e5f-6a7b-8c9d0e1f2a3b","status": "succeeded","stage": null,"result_id": "1f2a3b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c","error": null,"billing": {"credits_reserved": 0,"credits_charged": 80,"kind": "ai_transcription"},"source": {"platform": "direct","media_id": null,"canonical_url": "https://media.example.com/podcasts/episode-104.mp3","title": null,"upload_id": null},"options": {"mode": "transcribe","language": null,"caption_preference": "prefer_creator"},"created_at": "2026-09-12T17:20:00Z"}
3.0Вопросы
Частые вопросы
Что происходит с субтитрами, AI-расшифровкой и ограничениями для этого источника.
Можно ли отправлять URL enclosure из RSS?
Да. Принимаются прямые ссылки HTTPS на аудиофайлы MP3, M4A или WAV, размещённые в сетях доставки контента подкастов.
Как работают вебхуки для длинных выпусков подкастов?
Вы можете передать webhook_endpoint_id в запросе задачи, чтобы получить автоматическое уведомление сразу после завершения расшифровки.