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

🎬 Scènes dynamiques — quand le plan change

• Avec voix : insère des marqueurs {scene} dans text entre les paragraphes. Chaque segment est cadencé par la narration et associé aux médias dans l’ordre. Les marqueurs sont retirés avant le TTS — la voix ne les lit jamais.
• Sans voix / explicite : passe scene_durations (ex. [10, 15, 5]) — une valeur par média. Les clips sont coupés/bouclés, les photos affichées pour la durée de la scène.
• Scènes ↔ médias : égal → 1:1 ; moins de scènes → la dernière se répartit sur le reste ; plus → le dernier média garde le reste.

✨ Transitions par coupe — comment le plan change

• Dans le texte : étends un marqueur avec un type et/ou une durée : {scene:slide}, {scene:zoom:0.8}, {scene:0.8} (durée seule). La transition s’applique à la coupe vers cette scène.
• Tableau explicite : scene_transitions (longueur = photos − 1), ex. ["slide","zoom","fade"] — une transition par coupe. Pratique pour les vidéos muettes à durées explicites.
• Types : fade · dissolve · slide · cover · reveal · zoom · squeeze · wind · pixel · circle · random. Les directionnelles (slide/cover/reveal/wind) choisissent une direction aléatoire par coupe.

🅰️ Texte sur la vidéo — légendes statiques

Ajoutez des légendes/titres arbitraires par-dessus la vidéo, indépendamment des sous-titres. Fonctionne avec ou sans narration. Chaque légende a son style, sa position, son timing et son fondu. Deux façons de les passer :

Structuré — text_overlays (tableau, 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 }
]

Styles de titre (style) : clean_white · bold_yellow · outline_black · soft_pink · elegant_script · news_bar · impact_red.

Codes — text_overlays_raw (chaîne). Syntaxe universelle en anglais (identique dans toutes les langues d'interface), analysée côté serveur. Une légende par ligne (ou séparées par /) ; champs internes séparés par |:

TEXT | attributes | start-end

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

• taille — small · medium · large
• graisse/italique — bold · thin · italic
• vertical — top · middle · bottom ; horizontal — left · center · right
• couleur — white · yellow · red · green · blue · pink · orange · purple · black · cyan
• temps — 0-3, 2.5-8, 5-end (s, point/virgule). Sans temps → la légende s'affiche tout le clip
• animation — pop · slide · type (machine à écrire) · fade · none

⚡ Auto-texte — légendes automatiques de mots-clés

auto_text: true active ⚡ Auto-texte. Au lieu de placer les légendes vous-même, un LLM lit les mots reconnus de la voix off, choisit les plus forts (noms, chiffres, affirmations percutantes) et les rend en légendes animées, exactement sur les timestamps de mots du TTS. Il choisit par mot un style moderne, une couleur et une animation d'apparition (pop / slide / typewriter), empile les mots dits ensemble et évite la zone des sous-titres.

• Nécessite une voix off (text non vide). Sans narration, il n'y a pas de timestamps de mots, donc auto_text est ignoré.
• Additif : les légendes générées s'ajoutent à vos text_overlays / text_overlays_raw, elles ne les remplacent pas.
• Entièrement automatique : aucun paramètre par mot. Si le LLM ne trouve rien, le rendu se poursuit simplement sans légendes supplémentaires (la requête n'échoue jamais).
• Quota : chaque rendu auto-texte réussi consomme une unité de votre quota mensuel (auto_text_limit ; gratuit limité, offres payantes illimitées). Au-delà de la limite → 429.
• L'auto-texte fonctionne dans tous les types de tâche de l'API : video, dubbing et subtitles. La traduction via l'API se fait par subtitles avec translate_to (pas de type translation séparé), donc auto_text couvre aussi les sous-titres traduits.

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