Recipe: storytime_broll

Status: Coming soon

Story-driven narration recipe with continuous B-roll, top-third hook, chapter beats, and captions.

Coming soon

Storytime B-Roll is planned and intentionally visible for roadmap clarity. The request shape may evolve before launch.

Bridge Note

Recipes are the recommended path. Use https://api.reelforger.com/v1/recipes/render as the canonical endpoint.

When to use it

Narrative videos with chapter beat overlays
Continuous B-roll under voiceover

Required inputs

voiceover_audio_url
background_video_url
transcript_words
hook_text
style_preset

Optional overrides

chapter_beats
hook_style/layout
chapter_beat_style/layout
captions_style/layout

Request structure

Send requests to https://api.reelforger.com/v1/recipes/render.
Use canonical field recipe_id.
Keep style_preset at the root and recipe-specific values inside variables.

Variable behavior guide

voiceover_audio_url: narration timeline driver.
background_video_url: continuous visual bed under narration.
hook_text: opening line shown near the start.
chapter_beats: optional moment markers by timecode.
captions_style / captions_layout: readability customization.

Payload and output preview

Payload example

{
  "recipe_id": "storytime_broll",
  "style_preset": "karaoke_yellow",
  "variables": {
    "voiceover_audio_url": "https://samplelib.com/lib/preview/mp3/sample-15s.mp3",
    "background_video_url": "https://storage.googleapis.com/gtv-videos-bucket/sample/ForBiggerJoyrides.mp4",
    "hook_text": "The greatest comeback ever.",
    "transcript_words": [{ "text": "Hello", "start": 0, "end": 900 }],
    "chapter_beats": [{ "label": "The Setup", "timecode_seconds": 4 }]
  }
}

Output preview

Preview MP4 pending chapter-beat visual set.

Constraints

hook_text max length is 60
chapter_beats max length is 10
out-of-bounds beats are silently dropped

Common mistakes and errors

Using long chapter labels
Assuming chapter beats outside duration will throw hard errors