API

API субтитров для разработчиков

Добавьте автоматические субтитры в продукт через REST API: отправьте видео, узнайте статус одним GET-запросом и скачайте файлы субтитров или видео с вшитыми субтитрами.

Читать документацию →

Как работает API

Ключ

Создайте ключ в разделе «Разработчикам». Он показывается один раз и передаётся заголовком Bearer.

Видео

Передайте ссылку на видеофайл или на YouTube — либо загрузите файл: PUT по подписанной ссылке или через сам API.

Статус

Ни писем, ни вебхуков настраивать не нужно: один GET отдаёт статус, прогресс и фактически списанные кредиты.

Файл

SRT, VTT или ASS — либо видео с вшитыми субтитрами: MP4, MOV, MP4 H.265 или WebM, в любом стиле из библиотеки шаблонов.

Задача на субтитры за три запроса

# 1. Submit a video — one request runs the whole pipeline
POST /v1/videos { "url": "…", "style": "neon" }

# 2. Poll until status is ready (the API sends no email)
GET  /v1/videos/{id}

# 3. Order the file, then pick up the link from GET …/exports
POST /v1/videos/{id}/exports { "format": "mp4" }

В каждом запросе — заголовок Authorization: Bearer cs_live_…. Адрес API — https://api.captions.space.

Все методы

Запрос	Что делает
`GET` `/v1/me`	Тариф, запас кредитов и остаток
`GET` `/v1/styles`	Шаблоны оформления — id для поля style
`GET` `/v1/formats`	Форматы выгрузки и расширения файлов
`POST` `/v1/videos`	Создать видео; с url прогон стартует сразу, без него — ответ с upload_url
`POST` `/v1/videos/{id}/file`	Залить файл через сам API (multipart) вместо PUT по upload_url
`POST` `/v1/videos/{id}/start`	Запустить обработку залитого файла
`GET` `/v1/videos`	Видео аккаунта, свежие сверху
`GET` `/v1/videos/{id}`	Статус, прогресс, ошибка и фактическое списание
`DELETE` `/v1/videos/{id}`	Удалить видео и его файлы
`POST` `/v1/videos/{id}/exports`	Заказать файл в формате и, если нужно, другом стиле
`GET` `/v1/videos/{id}/exports`	Готовые файлы со ссылками на скачивание

API и редактор работают вместе

Видео из API лежат в вашем кабинете: любое можно открыть в редакторе и поправить слово или тайминг.
Оформление, добавленное в редакторе, — шаблоны надписей, свой водяной знак — попадает в следующий видеофайл, заказанный через API.
Кредиты общие: редактор и API тратят один баланс.

Кредиты вместо прайс-листа

Один кредит — одна начатая минута обработанного видео.
В тарифе Pro 1000 кредитов на каждый 30-дневный период подписки — общих с редактором; запас обновляется в день продления.
Ролики до 30 минут. Видео длиннее остатка кредитов не обрезается, а отклоняется с понятным кодом ошибки.
Упавший прогон не стоит ничего; скачать готовое видео или выгрузить его в другом стиле — тоже.

API входит в тариф Pro: на тарифах Free и Lite ключи не выпускаются.

Смотреть тарифы →

Красивые субтитры.
Лучшие видео.

Captions Space создаёт AI-субтитры в дизайнерских стилях и экспортирует готовое видео в один клик.

Создать субтитры →

Без привязки карты

✓ Доступен бесплатный тариф
✓ Мгновенный экспорт в один клик
✓ Создано для креаторов

Работает в браузере — без установки, без привязки карты, с бесплатным тарифом на 6 минут видео в месяц.