Гайд · TNWS AI

Как получить таймкоды слов из ElevenLabs и сделать субтитры

WindowsmacOSLinux#ElevenLabs #озвучка #нейросети

12 сентября 2026 2 мин—

Практический разбор запроса «как получить таймкоды ElevenLabs»: реальные поля ElevenLabs API, рабочий пример, ограничения, диагностика и проверка аудио.

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

Точные факты

Ответ содержит base64-аудио и alignment-данные.
Выравнивание доступно на уровне символов.
Могут возвращаться alignment и normalized_alignment.
Начало и конец символа задаются временными массивами.
Нормализация чисел способна изменить соответствие исходному тексту.
SRT/VTT требуют группировки и ограничений длины строки.

Порядок работы

Вызовите endpoint convert-with-timestamps.
Декодируйте audio_base64 в бинарный файл.
Проверьте одинаковую длину массивов characters и времён.
Соберите слова с учётом пробелов и пунктуации.
Объедините слова в смысловые реплики по длительности и длине.
Проверьте первую, среднюю и последнюю реплики на waveform.

Рабочий пример

const b=Buffer.from(data.audio_base64,'base64');
await fs.writeFile('voice.mp3',b);
const a=data.normalized_alignment ?? data.alignment;
if(a.characters.length!==a.character_start_times_seconds.length) throw Error('bad alignment');

Как проверить результат

Откройте аудио и SRT в видеоредакторе. Контрольные слова в начале, середине и конце должны совпадать; пустые и отрицательные интервалы недопустимы.

Чего не делать

Не делите строку только по пробелам без временного сопоставления.
Не смешивайте исходный и normalized текст в одном индексе.
Не округляйте все времена до целых секунд.

Ограничения

Доступность моделей, форматов, языков, voice cloning и лимитов зависит от аккаунта и может меняться. Факты сверены с официальной документацией 12 сентября 2026 года; перед production-запуском повторно проверьте источник.

FAQ

Можно ли вызывать ElevenLabs прямо из браузера?

Не с постоянным секретным ключом: запрос должен идти через ваш backend.

Как проверить поддержку русского языка?

Получите актуальные сведения через Models API и сделайте тест на собственном тексте.

Нужно ли прослушивать результат?

Да, автоматическая проверка файла не выявляет неверные ударения и неестественную интонацию.

Где проверять цены и лимиты?

В официальной pricing-странице и панели аккаунта непосредственно перед расчётом.

Официальный источник

https://elevenlabs.io/docs/api-reference/text-to-speech/convert-with-timestamps