# Создать SRT-файл или WebVTT с временными метками

> Чтобы создать SRT-файл, отправьте ссылку на видео или файл. По тому же ID получите WebVTT, текст с временными метками или JSON с метками слов.

Canonical: https://transcript1.com/ru/features/sozdat-srt-fayl
Language: ru
Last updated: 2026-10-19

Чтобы создать SRT-файл или WebVTT, добавьте ссылку на видео либо загрузите запись. Поддерживаем YouTube, X, TikTok, Instagram, Facebook, Bluesky, Dailymotion, видеопосты LinkedIn, Snapchat Spotlight, видеопины Pinterest, клипы и завершённые VOD с Twitch. У каждого сегмента есть начало и конец. Тот же транскрипт можно прочитать как JSON или обычный текст с временными метками.

- JSON, текст, SRT и VTT из одной транскрибации
- Начало и конец у каждого сегмента
- Пословные временные метки через include=words

## Подберите формат для своего редактора или приложения

### Выбирайте формат при чтении

Для GET /v1/transcriptions/:id укажите format=json, text, srt или vtt. По умолчанию возвращаем JSON.

### Временная метка перед каждой строкой

Сочетание format=text и timestamps=true добавит в начало строк время в виде [hh:mm:ss]. Такой текст удобно хранить вместе с заметками.

### Субтитры для редактора или плеера

SRT приходит с типом application/x-subrip, VTT — с типом text/vtt и заголовком WEBVTT. Каждому сегменту соответствует один блок субтитров.

### Время отдельных слов

Добавьте include=words к запросу JSON, чтобы получить доступные временные метки слов, confidence и метки говорящих. В сегментах из субтитров автора words будет null.

### За другой формат повторно не платите

Текст, JSON и субтитры представляют одну готовую транскрибацию. Повторное чтение и смена формата не расходуют минуты.

## Транскрипт с таймкодами для заметок и цитат

Запросите обычный текст с timestamps=true. Если при создании вы включили определение говорящих, в строках будут и их метки. Параметры чтения описаны в [документации API](https://transcript1.com/ru/docs/api-reference#get-a-transcription).

Временная метка указывает на фрагмент исходной записи. Так можно сохранить цитату в документе без служебных строк SRT. Рядом оставьте ссылку на видео или имя файла: без них непонятно, к какой записи относится время.

В JSON начало и конец сегмента заданы в секундах от начала записи. Это не дата и не время на часах. Используйте эти значения для перехода в плеере или ссылок из заметок. Текст ниже приведён только как пример экспорта.

### format=text&timestamps=true

```
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text&timestamps=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 той же готовой транскрибации, без повторного расхода минут.

### format=srt

```
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](https://transcript1.com/ru/docs/api-reference#get-a-transcription).

После распознавания речи доступны начало, конец и confidence слова. У автоматических субтитров YouTube есть времена начала, а конец вычисляем по началу следующего слова. У субтитров автора YouTube и у всех субтитров других платформ, включая X, TikTok и Bluesky, времён слов нет. Для субтитров X в transcript_source будет x_captions. Предусмотрите отображение по сегментам, когда words равен null.

Граница слова не всегда подходит для склейки. Перед обрезкой прослушайте место вокруг неё, чтобы не отрезать начало звука или вдох. Для субтитров объединяйте слова в читаемые фразы и проверяйте их на экране того размера, для которого готовите видео.

### include=words

```
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?include=words" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
```

## Проверьте файл перед подключением к плееру

Сначала дождитесь status=completed. Пока работа идёт, API возвращает JSON со статусом, даже если вы запросили SRT, VTT или текст. Если плеер не принимает файл, проверьте, не сохранили ли вы этот JSON под расширением субтитров.

Сверяйте времена с окончательной версией записи. У фрагмента, вырезанного из середины, будет другое начало отсчёта. При [подготовке новых материалов из видео](https://transcript1.com/ru/use-cases/video-v-statyu-dlya-bloga) сохраните границы нужного отрывка, а субтитры выровняйте после монтажа.

Перед публикацией посмотрите запись с субтитрами в целевом плеере на обычной скорости. Проверьте длину строк, время на чтение и обозначение говорящих. Для доступности важен и контекст: значимые звуки или происходящее без слов могут потребовать ручных дополнений. Об этом — [руководство по доступным субтитрам](https://transcript1.com/ru/use-cases/dobavit-subtitry-k-video).

Храните ID готовой транскрибации вместе с экспортом. Если позже вместо SRT понадобится WebVTT или JSON со словами, прочитайте тот же ID в другом формате. Заново отправлять запись не нужно.

## Частые вопросы

### Как получить субтитры из видео или аудио в SRT?

Расшифруйте запись по ссылке YouTube или загрузите файл, например MP4. Затем запросите format=srt. Из той же транскрибации доступны WebVTT, обычный текст и JSON.

### В каком виде приходит время?

В JSON поля start и end содержат секунды от начала записи. В SRT и VTT используется обычная для этих форматов запись hh:mm:ss с миллисекундами.

### У субтитров YouTube есть время каждого слова?

У автоматических субтитров есть начало каждого слова. У субтитров автора words равен null. После распознавания речи доступны начало и конец слова, а также confidence.

### Можно скачать субтитры, пока запись обрабатывается?

Нет. SRT, VTT и текст доступны только после завершения транскрибации. До этого API вернёт JSON, чтобы вы могли проверить статус.

## Читайте также

- [Субтитры и доступность](https://transcript1.com/ru/use-cases/dobavit-subtitry-k-video)
- [Подкасты и SEO](https://transcript1.com/ru/use-cases/rasshifrovka-podkasta)
- [Определение говорящих](https://transcript1.com/ru/features/opredeleniye-govoryashchikh-v-audio)
- [Справочник по API (документация)](https://transcript1.com/ru/docs/api-reference)
