Reelora API

Type: video — video creation

Photos or video clips + voiceover + karaoke subtitles + music → MP4.

{
  "type": "video",
  "photos": ["upload_id_1", "https://example.com/img.jpg"],
  "text": "Text for voiceover",
  "scene_durations": null, "scene_transitions": null, "target_duration": 30,
  "format": "9_16", "animation": "ken_burns", "transition": "random", "transition_duration": 0.5,
  "tts_provider": "google", "tts_voice": "Chirp3-HD-Aoede",
  "tts_scene": "Speak like a news anchor.",
  "subtitles": true, "sub_style": "yellow_basic", "sub_position": "bottom",
  "bgm_track": "chill_background-lofi-vibes-113884.mp3", "bgm_volume": 0.2
}

audio_mix_type — for clips with original sound

🎬 Динамические сцены — когда менять кадр

• С озвучкой: вставь маркеры {scene} в text между абзацами. Каждый сегмент таймится по озвучке и мапится на media по порядку. Маркеры убираются перед TTS — голос их не читает.
• Без озвучки / явно: передай scene_durations (напр. [10, 15, 5]) — по одному значению на media. Видео-клипы обрезаются/зацикливаются под сцену, фото показываются заданное время.
• Сцены ↔ media: поровну → 1:1; меньше сцен → последняя делится на остальные; больше → последнее media держит остаток.

✨ Переходы между кадрами — как менять кадр

• В тексте: расширь маркер типом и/или длительностью: {scene:slide}, {scene:zoom:0.8}, {scene:0.8} (только длительность). Переход применяется к стыку в эту сцену.
• Явный массив: scene_transitions (длина = photos − 1), напр. ["slide","zoom","fade"] — по одному переходу на стык. Удобно для видео без текста с явными длительностями.
• Типы: fade · dissolve · slide · cover · reveal · zoom · squeeze · wind · pixel · circle · random. Направленные (slide/cover/reveal/wind) выбирают случайное направление на каждом стыке.

🅰️ Текст на видео — статичные надписи

Добавь произвольные надписи/титры поверх видео, независимо от субтитров. Работает с озвучкой или без. У каждой надписи свой стиль, позиция, тайминг и плавное появление/исчезновение. Два способа передать:

Структурировано — text_overlays (массив, макс. 10):

"text_overlays": [
  { "text": "BIG TITLE", "style": "bold_yellow", "size": "large",
    "position": "top_center", "start": 0.0, "end": 3.0, "fade": true, "anim": "pop" },
  { "text": "the end", "style": "soft_pink", "position": "bottom_center", "start": 3.0 }
]

Стили титров (style): clean_white · bold_yellow · outline_black · soft_pink · elegant_script · news_bar · impact_red.

Коды — text_overlays_raw (строка). Универсальный англоязычный синтаксис (одинаков в любом языке интерфейса), парсится на сервере. Одна надпись на строку (или через /); поля внутри надписи — через |:

TEXT | attributes | start-end

"text_overlays_raw": "Hello | large italic center | 0-3 / Subscribe | bottom pink pop | 3-end"

• размер — small · medium · large
• вес/наклон — bold · thin · italic
• вертикаль — top · middle · bottom; горизонталь — left · center · right
• цвет — white · yellow · red · green · blue · pink · orange · purple · black · cyan
• время — 0-3, 2.5-8, 5-end (сек, точка/запятая). Без времени → надпись видна весь ролик
• анимация — pop · slide · type (печатная машинка) · fade · none

⚡ Авто-текст — автоматические надписи ключевых слов

auto_text: true включает ⚡ Авто-текст. Вместо ручной расстановки надписей LLM читает распознанные слова озвучки, сам выбирает самые сильные (имена, числа, громкие утверждения) и рендерит их как анимированные надписи, точно по таймкодам слов TTS. Выбирает современный стиль, цвет и анимацию появления (pop / slide / typewriter) для каждого слова, складывает звучащие вместе слова в стек и не лезет в зону субтитров.

• Нужна озвучка (text не пустой). Без озвучки таймкодов слов нет — auto_text игнорируется.
• Дополнительно: сгенерированные надписи добавляются к твоим text_overlays / text_overlays_raw, а не заменяют их.
• Полностью автоматически: параметров на слово нет. Если LLM ничего не подобрал — рендер просто идёт без доп. надписей (запрос не падает).
• Квота: каждый успешный рендер с авто-текстом списывает единицу месячной квоты (auto_text_limit; на Free — ограничено, на платных — безлимит). Превышение → 429.
• Авто-текст работает во всех таск-типах API: video, dubbing и subtitles. Перевод по API делается через subtitles с translate_to (отдельного типа translation нет), поэтому auto_text охватывает и переведённые субтитры.

Type: transcription — transcription

Audio or video → text + .SRT with timecodes.

{
  "type": "transcription", "file": "upload_id_or_https_url",
  "language": "uk", "ai_prompt": "Medical podcast. Correct terminology.",
  "output_format": "both"
}

// result_urls for transcription
{ "txt_url": "https://cdn.reelora.cc/.../transcript.txt",
  "srt_url": "https://cdn.reelora.cc/.../transcript.srt" }

Type: audio — voiceover (TTS)

Text → MP3 file without video.

{
  "type": "audio", "text": "Hello! This is a Reelora API test.",
  "tts_provider": "gemini", "tts_voice": "Puck",
  "tts_speed": 1.0, "tts_scene": "Warm and friendly tone",
  "tts_style": "expressive"
}

Type: subtitles — subtitles on video

Burns karaoke subtitles into a finished video via Whisper + FFmpeg. Standard+ plan.

{
  "type": "subtitles", "file": "upload_id_or_https_url",
  "language": "uk", "sub_style": "yellow_basic",
  "sub_position": "bottom", "sub_size": "medium"
}

Result: MP4 with subtitles in result_url. Seconds are deducted from the monthly limit.

Type: pause_removal — pause removal

Automatically cuts out silence and pauses from video. Standard+ plan. Silence threshold is detected automatically.

{ "type": "pause_removal", "file": "upload_id_or_https_url" }

Result: processed MP4 in result_url.

Type: dubbing — AI dubbing

Transcribes video, translates, synthesizes a new voice, mixes audio. Three modes. Available on all plans within the monthly limit.

Mode A: auto — fully automatic

{
  "type": "dubbing", "mode": "auto",
  "file": "upload_id_or_https_url",
  "source_lang": "auto", "target_lang": "en",
  "tts_provider": "edge", "tts_voice": "en-US-GuyNeural",
  "mix_mode": "overlay", "overlay_volume": 20,
  "sub_lang": "dubbed", "sub_style": "yellow_basic"
}

Mode B: semi_auto — with verification (2 steps)

// Step 1: transcription
{ "type": "dubbing", "mode": "semi_auto", "step": "transcribe",
  "file": "upload_id_video", "source_lang": "uk", "target_lang": "en" }
// → srt_url: download, edit, upload via /v1/uploads

// Step 2: render with edited SRT
{ "type": "dubbing", "mode": "semi_auto", "step": "render",
  "file": "upload_id_video", "srt_file": "upload_id_of_your_srt",
  "target_lang": "en", "tts_provider": "edge",
  "tts_voice": "en-US-GuyNeural", "mix_mode": "overlay", "overlay_volume": 20 }

Mode C: manual — own SRT file

Skips transcription. You provide your own SRT file containing text in the target language.

{ "type": "dubbing", "mode": "manual",
  "file": "upload_id_video", "srt_file": "upload_id_of_srt_file",
  "target_lang": "uk", "tts_voice": "uk-UA-Wavenet-A", "mix_mode": "replace" }