Recipe: photo_slideshow

Status: Live

Image-first slideshow paced from soundtrack duration with built-in Ken Burns motion cycle.

Bridge Note

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

When to use it

You have multiple images and one backing audio track
You need deterministic per-slide pacing from audio duration

Input assets

This example uses the following assets:

Required inputs

audio_url
image_urls (min 2)
style_preset

Optional overrides

audio_start_seconds (trim start of audio)
audio_duration_seconds (cap slideshow duration, max 60s)
title_card_text
title_card_style (default: big bold white 96px)
title_card_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

audio_url: soundtrack used to pace total slideshow duration.
image_urls: ordered slide list; each image becomes one segment.
audio_start_seconds: skip intro by starting audio at an offset.
audio_duration_seconds: hard cap for final duration.
title_card_text: optional opening title card.

Payload and output preview

Payload example

{
  "recipe_id": "photo_slideshow",
  "style_preset": "luxury_serif",
  "variables": {
    "audio_url": "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/coastal%20escape%20music.mp3",
    "image_urls": [
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%201.jpeg",
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%202.jpeg",
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%203.jpeg",
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%204.jpeg",
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%205.jpeg",
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%206.jpeg",
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%207.jpeg",
      "https://pub-2ad5592bc4ca44abb609acfc0b7c5ceb.r2.dev/reel-forge-website-assets/Coastal%20Escape%208.jpeg"
    ],
    "audio_start_seconds": 19,
    "audio_duration_seconds": 25,
    "title_card_text": "Coastal Escape"
  }
}

Output preview

Coastal Escape luxury travel slideshow: 8 images, 25s, music from 19s, big bold white title.

Constraints

image_urls must include at least two images
Final pacing derives from probed audio duration (or audio_duration_seconds if set)
Total duration capped at 60 seconds
title_card_text uses big bold white (96px, 800 weight) by default; override with title_card_style

Common mistakes and errors

Using inaccessible image URLs
Supplying only one image URL
Omitting audio_duration_seconds when audio exceeds 60s