Загрузить субтитры

PUT/api/v1/content/{id}/video-text

Доступ: Ключ API
Право: content:write

SRT, WebVTT или расшифровка текстом для готового видео. Одна дорожка на видео: новая заменяет прежнюю, её байты идут в квоту. Реплики — до 2000, их начала не убывают, конец каждой — после начала и не позже длительности видео плюс секунда; перекрытия допустимы, оформление хранится как текст.

Пример запроса

curl -X PUT "https://lac.pics/api/v1/content/Xq3u9RkT0bLmA7cV2pWz1eFy/video-text" \
  -H "Authorization: Bearer lac_api_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "expectedRevision": 0,
  "format": "srt",
  "text": "1\n00:00:00,000 --> 00:00:02,500\nHello!\n",
  "language": "en",
  "label": "English"
}'

Параметры

Путь

idstringобязательный
id файла или заметки.

Тело запроса

application/jsonобязательный

expectedRevisionintegerобязательный
Ревизия, которую ты читал (revision; у видео без текста — 0). Другая — 409.
0–2 147 483 646
formatstringобязательный
srt, vtt или text — расшифровка без таймкодов.
значения: "srt" "vtt" "text"
textstringобязательный
До 256 КБ UTF-8 и 2000 реплик: SRT, WebVTT или расшифровка. Распознавания речи нет.
не длиннее 200 000
languagestring
Язык дорожки по BCP 47: ru, en-US.
не длиннее 35 · шаблон ^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$
labelstring
Подпись дорожки в плеере, до 80 символов.
не длиннее 80

Ответы

200ГотовоVideoTextResponse
- revisionintegerобязательный
  Ревизия текста видео.
  0–2 147 483 647
- trackobjectобязательныйили null
  Дорожка субтитров или null.
  4 поля
  - formatstringобязательный
    plain — текст, markdown — Markdown, code — код с подсветкой.
    значения: "vtt" "text"
  - languagestringобязательный
    Язык подсветки для формата code; для текста и Markdown не используется.
  - labelstringобязательный
    Подпись дорожки в плеере, до 80 символов.
  - textstringобязательный
    Текст заметки, 1–200 000 символов.
- transcriptstringобязательный
  Расшифровка.
400Некорректный запрос
401Нужен действующий ключ
403Нет права или функции тарифа
404Не найдено
409Конфликт
413Слишком большой файл или нет места
429Слишком много запросов
500Сбой на сервере
503Сервис занят или недоступен

Пример ответа

200 · application/json

{
  "revision": 1,
  "track": null,
  "transcript": "Hello!"
}

Коды ошибок

Ответы любого метода с ключом — неверный или истёкший ключ, нет права, частые запросы — в разделе Ошибки.