SRTGen.com LogoSRTGen.com

Экспорт субтитров

Скачивайте субтитры в предпочитаемых форматах и отслеживайте статус ваших проектов транскрибации в реальном времени.

POST/api/v1/export/:projectId
Быстрая реализация
curl -X POST https://api.srtgen.com/api/v1/export/proj_8k2n9m1b \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "output": "srt"
}'
POSThttps://api.srtgen.com/api/v1/export/proj_8k2n9m1b

Параметры

ПараметрТипОбязателенОписание
Основные параметры
idStringYes

Уникальный идентификатор проекта, передаваемый в пути URL.

outputStringNo

Желаемый формат субтитров или медиаресурс для экспорта.

Варианты: srt, vtt, ass, txt, json, mp4 | По умолчанию: srt

burnIdStringNo

Явный запрос статуса/результата конкретного ID задачи вшивания.

languageStringNo

Целевой язык для субтитров.

Диапазон: Любой переведенный код или 'original' | По умолчанию: оригинальный

Поддержка нескольких языков (новое)
languagesArrayNo

Массив конфигураций для отображения нескольких языков в одном файле.

Лимит: макс. 3 языка | По умолчанию: По умолчанию: ASS, VTT

-language
StringYes*

Код для этого слота языка (например, 'zh' или 'original').

-lineBreakRules
ObjectNo

Переопределение сегментации для конкретного языка.

-styleSettings
ObjectNo

Стилизация для конкретного языка (основное для ASS).

Правила переноса строк (lineBreakRules)
lineBreakRulesObjectNo

Вложенный объект для логики сегментации субтитров.

-maxChars
NumberNo

Максимально допустимое количество символов в строке.

Диапазон: 5 - 100 | По умолчанию: 45

-maxWords
NumberNo

Максимально допустимое количество слов в строке.

Диапазон: 1 - 20 | По умолчанию: 10

-balanceLines
BooleanNo

Выравнивает длину строк в многострочных субтитрах.

По умолчанию: true

-sentenceSplit
BooleanNo

Предпочитать разрыв строк в конце предложений.

По умолчанию: true

-gapThreshold
NumberNo

Максимальная пауза (в секундах) между словами в строке.

Диапазон: 0.1 - 2.0 | По умолчанию: 0.4

Основы стиля (styleSettings)
uppercaseBooleanNo

Принудительно перевести весь текст в верхний регистр.

styleSettingsObjectNo

Вложенный объект для переопределения визуального оформления.

-preset
StringNo

Применить встроенный пресет стиля в качестве основы.

Варианты: standard-stream, classic-apple, etc.

-fontSize
NumberNo

Размер шрифта как отношение к высоте видео.

По умолчанию: 0.045 (approx 48px)

-fontFamily
StringNo

Стандартное имя шрифта, используемое для рендеринга.

По умолчанию: Стандартное имя шрифта, используемое для рендеринга.

-bold
BooleanNo

Применить жирное начертание к тексту.

Диапазон: true | false | По умолчанию: false

-italic
BooleanNo

Применить курсив к тексту.

Диапазон: true | false | По умолчанию: false

Цвета и границы
-primaryColor
HexNo

Hex-код основного цвета текста.

По умолчанию: #FFFFFF

-secondaryColor
HexNo

Вторичный цвет (используется для эффектов караоке).

По умолчанию: #00FFFF

-outlineColor
HexNo

Цвет контура текста.

По умолчанию: #000000

-outline
NumberNo

Толщина контура (отношение к высоте).

По умолчанию: 0.002

-shadow
NumberNo

Глубина тени (отношение к высоте).

По умолчанию: 0.001

Позиционирование (коэффициенты 0-1)
-alignment
NumberNo

Код выравнивания ASS (1-9). Снизу по центру — 2.

Диапазон: 1 - 9 | По умолчанию: 2

-posX
NumberNo

Горизонтальное положение (0 = слева, 1 = справа).

Диапазон: 0.0 - 1.0 | По умолчанию: 0.5

-posY
NumberNo

Коэффициент вертикального положения (0 = сверху, 1 = снизу). По умолчанию: 0.88.

Диапазон: 0.0 - 1.0 | По умолчанию: 0.88

-marginV
NumberNo

Коэффициент вертикального отступа от низа/верха. По умолчанию: 0.056.

Диапазон: 0.0 - 0.5 | По умолчанию: 0.056

Анимация и эффекты
-fadeIn
NumberNo

Длительность появления в миллисекундах.

Диапазон: 0ms - 5000ms | По умолчанию: 0

-fadeOut
NumberNo

Длительность затухания в миллисекундах.

Диапазон: 0ms - 5000ms | По умолчанию: 0

-karaoke
StringNo

Тип тега караоке (k, kf, ko, ks).

Варианты: k, kf, ko, ks | По умолчанию: none

Модерн: Виральное видео SRT
curl -X POST https://api.srtgen.com/api/v1/export/proj_8k2n9m1b \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "output": "srt",
  "language": "fr",
  "lineBreakRules": {
    "maxChars": 25,
    "maxWords": 5,
    "balanceLines": true
  }
}'
POSThttps://api.srtgen.com/api/v1/export/proj_8k2n9m1b
Дополнительно: Профессиональный стиль ASS
curl -X POST https://api.srtgen.com/api/v1/export/proj_8k2n9m1b \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "output": "ass",
  "lineBreakRules": {
    "maxChars": 30
  },
  "styleSettings": {
    "preset": "standard-stream",
    "fontSize": 55,
    "primaryColor": "#FF0000",
    "bold": true
  }
}'
POSThttps://api.srtgen.com/api/v1/export/proj_8k2n9m1b
Двуязычный: ASS/VTT на двух языках
curl -X POST https://api.srtgen.com/api/v1/export/proj_8k2n9m1b \
  -H "x-api-key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "output": "ass",
  "languages": [
    {
      "language": "original",
      "styleSettings": {
        "preset": "classic-apple",
        "fontSize": 40,
        "posY": 0.85
      }
    },
    {
      "language": "zh",
      "lineBreakRules": {
        "maxChars": 16,
        "balanceLines": false
      },
      "styleSettings": {
        "preset": "standard-stream",
        "fontSize": 55,
        "posY": 0.7
      }
    }
  ]
}'
POSThttps://api.srtgen.com/api/v1/export/proj_8k2n9m1b

Структура ответа

1. Состояние обработки

Если проект все еще обрабатывается нашим AI-движком или ожидает очереди, вы получите обновление статуса, указывающее на его текущее состояние.

Это позволяет вам реализовать простой опрос (polling) на вашем фронтенде, используя тот же эндпоинт, пока статус не станет completed.

Ответ: 200 OK
{
  "projectId": "proj_abc123",
  "status": "processing",
  "message": "AI is generating..."
}

2. Состояние завершения

После завершения ответ включает содержимое субтитров в запрошенном вами формате.

Каждый формат оптимизирован для своего случая использования:

Результат JSON
SRT / VTT
Стиль ASS
Простой текст
Ответ: 200 OK
{
  "success": true,
  "projectId": "proj_abc123",
  "status": "completed",
  "format": "srt",
  "content": "1\\n00:00:01,000 --> 00:00:03,000\\nHello..."
}

Коды ошибок

СтатусКод ошибкиОписание
400param_not_validПредоставленный параметр выходит за пределы допустимого диапазона.
401unauthorizedКлюч API отсутствует или недействителен.
404not_foundID проекта не существует.
500export_errorПроизошла ошибка при форматировании.
500project_fetch_failedНе удалось получить данные проекта.
500server_errorПроизошла непредвиденная внутренняя ошибка сервера.
Структура ответа с ошибкой
{
  "success": false,
  "error": "unauthorized",
  "message": "Предоставленный ключ API недействителен или просрочен."
}
Была ли эта страница полезна?
Экспорт субтитров | SRTGen.com