Транскрипт с таймкодами для заметок и цитат
Запросите обычный текст с timestamps=true. Если при создании вы включили определение говорящих, в строках будут и их метки. Параметры чтения описаны в документации API.
Временная метка указывает на фрагмент исходной записи. Так можно сохранить цитату в документе без служебных строк SRT. Рядом оставьте ссылку на видео или имя файла: без них непонятно, к какой записи относится время.
В JSON начало и конец сегмента заданы в секундах от начала записи. Это не дата и не время на часах. Используйте эти значения для перехода в плеере или ссылок из заметок. Текст ниже приведён только как пример экспорта.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text×tamps=true" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
[00:00:00] Place the microphone near the speaker.
[00:00:04] Record a short test before the interview.Создать VTT-файл или выбрать SRT?
В SRT блоки пронумерованы, у каждого есть начало и конец. WebVTT начинается с WEBVTT и подходит для HTML-элемента track. Дождитесь завершения транскрибации, затем запросите format=srt или format=vtt и сохраните ответ.
Выбирайте формат, который принимает ваш инструмент. SRT часто используют при монтаже и загрузке субтитров. WebVTT подходит для дорожки субтитров в HTML-плеере. Внешний вид текста задаёт редактор или плеер: файл не накладывает надписи на видеокадр и не переносит оформление из соцсети.
У форматов отличается запись времени: в SRT перед миллисекундами стоит запятая, в WebVTT — точка. Переименование расширения не конвертирует файл. Получите нужный формат по ID той же готовой транскрибации, без повторного расхода минут.
1
00:00:00,000 --> 00:00:04,200
Place the microphone near the speaker.
2
00:00:04,200 --> 00:00:09,800
Record a short test before the interview.Пословные временные метки для подсветки и монтажа
При чтении JSON укажите include=words. Если источник содержит времена слов, их можно использовать для подсветки текста или выбора фрагмента. Иначе вернётся words: null. Поля перечислены в справочнике API.
После распознавания речи доступны начало, конец и confidence слова. У автоматических субтитров YouTube есть времена начала, а конец вычисляем по началу следующего слова. У субтитров автора YouTube и у всех субтитров других платформ, включая X, TikTok и Bluesky, времён слов нет. Для субтитров X в transcript_source будет x_captions. Предусмотрите отображение по сегментам, когда words равен null.
Граница слова не всегда подходит для склейки. Перед обрезкой прослушайте место вокруг неё, чтобы не отрезать начало звука или вдох. Для субтитров объединяйте слова в читаемые фразы и проверяйте их на экране того размера, для которого готовите видео.
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?include=words" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY"Проверьте файл перед подключением к плееру
Сначала дождитесь status=completed. Пока работа идёт, API возвращает JSON со статусом, даже если вы запросили SRT, VTT или текст. Если плеер не принимает файл, проверьте, не сохранили ли вы этот JSON под расширением субтитров.
Сверяйте времена с окончательной версией записи. У фрагмента, вырезанного из середины, будет другое начало отсчёта. При подготовке новых материалов из видео сохраните границы нужного отрывка, а субтитры выровняйте после монтажа.
Перед публикацией посмотрите запись с субтитрами в целевом плеере на обычной скорости. Проверьте длину строк, время на чтение и обозначение говорящих. Для доступности важен и контекст: значимые звуки или происходящее без слов могут потребовать ручных дополнений. Об этом — руководство по доступным субтитрам.
Храните ID готовой транскрибации вместе с экспортом. Если позже вместо SRT понадобится WebVTT или JSON со словами, прочитайте тот же ID в другом формате. Заново отправлять запись не нужно.