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

🎬 Dynamische Szenen — wann der Schnitt wechselt

• Mit Stimme: füge {scene}-Marker in text zwischen Absätzen ein. Jedes Segment wird durch die Erzählung getaktet und der Reihe nach den Medien zugeordnet. Marker werden vor TTS entfernt — die Stimme liest sie nie.
• Ohne Stimme / explizit: übergib scene_durations (z. B. [10, 15, 5]) — ein Wert pro Medium. Clips werden zugeschnitten/geloopt, Fotos für die Szenenlänge gezeigt.
• Szenen ↔ Medien: gleich → 1:1; weniger Szenen → die letzte teilt sich auf den Rest; mehr → das letzte Medium hält den Rest.

✨ Übergänge pro Schnitt — wie der Schnitt wechselt

• Im Text: erweitere einen Marker um Typ und/oder Dauer: {scene:slide}, {scene:zoom:0.8}, {scene:0.8} (nur Dauer). Der Übergang gilt für den Schnitt in diese Szene.
• Explizites Array: scene_transitions (Länge = photos − 1), z. B. ["slide","zoom","fade"] — ein Übergang pro Schnitt. Praktisch für stumme Videos mit expliziten Dauern.
• Typen: fade · dissolve · slide · cover · reveal · zoom · squeeze · wind · pixel · circle · random. Gerichtete (slide/cover/reveal/wind) wählen pro Schnitt eine zufällige Richtung.

🅰️ Text im Video — statische Einblendungen

Füge beliebige Beschriftungen/Titel über dem Video hinzu, unabhängig von den Untertiteln. Mit oder ohne Sprecher. Jede Einblendung hat eigenen Stil, Position, Timing und Ein-/Ausblendung. Zwei Wege:

Strukturiert — text_overlays (Array, max. 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 }
]

Titelstile (style): clean_white · bold_yellow · outline_black · soft_pink · elegant_script · news_bar · impact_red.

Codes — text_overlays_raw (String). Universelle englische Syntax (in jeder UI-Sprache gleich), serverseitig geparst. Eine Einblendung pro Zeile (oder durch /); Felder innerhalb durch |:

TEXT | attributes | start-end

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

• Größe — small · medium · large
• Gewicht/Kursiv — bold · thin · italic
• vertikal — top · middle · bottom; horizontal — left · center · right
• Farbe — white · yellow · red · green · blue · pink · orange · purple · black · cyan
• Zeit — 0-3, 2.5-8, 5-end (Sek., Punkt/Komma). Ohne Zeit → Einblendung im ganzen Clip
• Animation — pop · slide · type (Schreibmaschine) · fade · none

⚡ Auto-Text — automatische Schlüsselwort-Einblendungen

auto_text: true aktiviert ⚡ Auto-Text. Statt Einblendungen selbst zu platzieren, liest ein LLM die erkannten Wörter des Voice-overs, wählt die stärksten (Namen, Zahlen, prägnante Aussagen) und rendert sie als animierte Einblendungen, exakt auf den TTS-Wort-Timestamps. Es wählt pro Wort einen modernen Stil, Farbe und Erscheinungs-Animation (pop / slide / typewriter), stapelt zusammen gesprochene Wörter und hält sich aus der Untertitelzone.

• Erfordert ein Voice-over (text nicht leer). Ohne Sprecher gibt es keine Wort-Timestamps, daher wird auto_text ignoriert.
• Additiv: erzeugte Einblendungen werden an deine text_overlays / text_overlays_raw angehängt, sie ersetzen sie nicht.
• Voll automatisch: keine Parameter pro Wort. Findet das LLM nichts, läuft das Rendering einfach ohne Zusatz-Einblendungen weiter (der Request schlägt nie fehl).
• Kontingent: jedes erfolgreiche Auto-Text-Rendering verbraucht eine Einheit deines Monatskontingents (auto_text_limit; Free begrenzt, Bezahlpläne unbegrenzt). Über dem Limit → 429.
• Auto-Text funktioniert in allen API-Task-Typen: video, dubbing und subtitles. Übersetzung per API läuft über subtitles mit translate_to (kein eigener translation-Typ), daher deckt auto_text auch übersetzte Untertitel ab.

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" }