Reelora API

Тип: video — створення відео

Фото або відео-кліпи + войсовер + karaoke-субтитри + музика → MP4.

{
  "type": "video",
  "photos": ["upload_id_1", "upload_id_2", "https://example.com/img.jpg"],
  "text": "Перша сцена {scene:slide} Друга сцена {scene:zoom:0.8} Третя сцена",
  "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", "language": "uk",
  "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 — для кліпів з оригінальним звуком

🎬 Динамічні сцени — коли змінювати кадр

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

Тип: transcription — транскрипція

Аудіо або відео → текст + .SRT з таймкодами.

{
  "type": "transcription", "file": "upload_id_або_https_url",
  "language": "uk", "ai_prompt": "Медичний подкаст. Виправляй термінологію.",
  "output_format": "both"
}

// result_urls для транскрипції
{ "txt_url": "https://cdn.reelora.cc/.../transcript.txt",
  "srt_url": "https://cdn.reelora.cc/.../transcript.srt" }

Тип: audio — озвучка (TTS)

Текст → MP3 файл без відео.

{
  "type": "audio", "text": "Привіт! Це тест Reelora API.",
  "tts_provider": "gemini", "tts_voice": "Puck",
  "tts_speed": 1.0, "tts_scene": "Warm and friendly tone",
  "tts_style": "expressive"
}

Тип: subtitles — субтитри на відео

Накладає karaoke-субтитри на готове відео через Whisper + FFmpeg. Тариф Standard+.

{
  "type": "subtitles", "file": "upload_id_або_https_url",
  "language": "uk", "sub_style": "yellow_basic",
  "sub_position": "bottom", "sub_size": "medium"
}

Результат: MP4 з субтитрами у result_url. Секунди рахуються з місячного ліміту.

Тип: pause_removal — видалення пауз

Автоматично вирізає тишу і паузи з відео. Тариф Standard+. Поріг тиші визначається автоматично.

{ "type": "pause_removal", "file": "upload_id_або_https_url" }

Результат: оброблений MP4 у result_url.

Тип: dubbing — AI дублювання

Транскрибує відео, перекладає, синтезує новий голос, мікшує аудіо. Три режими. Доступний на всіх тарифах у межах місячного ліміту.

Режим A: auto — повністю автоматично

{
  "type": "dubbing", "mode": "auto",
  "file": "upload_id_або_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"
}

Режим B: semi_auto — з перевіркою (2 кроки)

// Крок 1: транскрипція
{ "type": "dubbing", "mode": "semi_auto", "step": "transcribe",
  "file": "upload_id_відео", "source_lang": "uk", "target_lang": "en" }
// → srt_url: скачай, відредагуй, завантаж через /v1/uploads

// Крок 2: рендер з відредагованим SRT
{ "type": "dubbing", "mode": "semi_auto", "step": "render",
  "file": "upload_id_відео", "srt_file": "upload_id_твого_srt",
  "target_lang": "en", "tts_provider": "edge",
  "tts_voice": "en-US-GuyNeural", "mix_mode": "overlay", "overlay_volume": 20 }

Режим C: manual — свій SRT файл

Пропускає транскрипцію. Надаєш власний SRT файл з текстом цільової мови.

{ "type": "dubbing", "mode": "manual",
  "file": "upload_id_відео", "srt_file": "upload_id_srt_файлу",
  "target_lang": "uk", "tts_voice": "uk-UA-Wavenet-A", "mix_mode": "replace" }