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).
• Coût : chaque rendu auto-texte réussi coûte 50 jetons. Si le solde est insuffisant → 402.
• 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.

🎬 Cartes IA — cartes animées sur la vidéo

ai_graphics: true active 🎬 Cartes IA (scènes intelligentes) : cartes animées sur la vidéo — listes, nombres, citations, comparaisons, étapes, graphiques barres/pourcentage, flèches de tendance, et cartes CTA subscribe / like. Les cartes évitent les visages et la zone des sous-titres automatiquement. Disponible pour video, subtitles et dubbing.

• ai_graphics_mode: auto (LLM picks moments from the voice-over; needs narration) · semi (auto + your directives) · manual (only your directives; works on a silent video).
• ai_graphics_density: 0.6 (rare) · 1.0 (normal) · 1.5 (dense).
• ai_graphics_directives (manual / semi): one card per line — MM:SS[-MM:SS] template args [@position]. Templates: caption, quote, subscribe, like, list, steps, stat, percent, trend, compare. Positions: @center @top @bottom @left @right.
• ai_graphics_sfx: a short sound as each card appears. Quota: ai_graphics_limit per month (over → 429; feature not on plan → 403). Never fatal.

{
  "type": "video", "photos": ["upload_abc"],
  "text": "Three things to pack for Hawaii...",
  "ai_graphics": true, "ai_graphics_mode": "auto",
  "ai_graphics_density": 1.0, "ai_graphics_sfx": "whoosh"
}

🔊 Effets sonores

Effets sonores courts synchronisés aux événements à l'écran. Canaux indépendants et facultatifs — désactivés par défaut (null = silence). La valeur est le nom de fichier (sans extension) d'un son de la bibliothèque SFX.

Les sons sont mixés sous la voix/musique. Dans le bot Telegram : ⚡ Auto-texte, 🎬 Cartes IA et 🎵 Fond.

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

Grave les sous-titres karaoké dans une vidéo finie via Whisper + FFmpeg. 50 jetons par minute.

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

Résultat : fichier MP4 avec sous-titres dans result_url. Les jetons sont facturés selon la durée du résultat.

Type: pause_removal — pause removal

Coupe automatiquement les silences et pauses de la vidéo. 50 jetons par minute. Le seuil de silence est détecté automatiquement.

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

Result: processed MP4 in result_url.

Type: dubbing — AI dubbing

Transcrit la vidéo, traduit, synthétise une nouvelle voix, mixe l'audio. Trois modes. Disponible à tous : 100–141 jetons par minute, selon la voix.

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

Type : smart_clip — clips intelligents

Une longue vidéo (podcast, interview, vlog) → Whisper détecte la langue → un LLM choisit les moments les plus forts et autonomes → ffmpeg découpe plusieurs clips courts prêts à l'emploi. Un appel = plusieurs clips. Nécessite une offre avec clips intelligents.

{
  "type": "smart_clip", "file": "upload_id_or_https_url",
  "max_clips": 6, "target_sec": 60, "language": "uk",
  "context": "podcast business, cherche des conseils et citations fortes",
  "reels_mode": true, "subtitles": true, "sub_style": "yellow_basic",
  "auto_text": true, "filters": ["cinema"],
  "webhook_url": "https://mysite.com/hooks/reelora"
}

Les clips reviennent dans result_urls.clips[]. result_url = le premier clip (compatibilité). Champs du clip : title, hook, start/end/duration, score (1–100).

{
  "task_id": 12345, "status": "completed",
  "result_urls": { "clips": [
    { "index": 1, "title": "...", "hook": "...",
      "start": 132.4, "end": 197.8, "duration": 65.4,
      "score": 92, "result_url": "https://cdn.../..._01_....mp4" }
  ] }
}

Type: motion — motion video

Turn text, a voice-over or a talking-head clip into a fully animated video (Remotion): a text/graphics explainer or a dynamic auto-edit. One call = one mp4. Requires a plan with motion enabled (or booster credits).

{
  "type": "motion", "source": "text",
  "text": "Three habits that quietly ruin your focus…",
  "format": "9:16", "style": "cream_editorial",
  "bgm_track": "chill_background-lofi-vibes-113884.mp3", "bgm_volume": 0.2,
  "webhook_url": "https://mysite.com/hooks/reelora"
}