A 10-photo listing reel with voiceover, music and captions costs about 3 cents on ReelSDK: one POST /v1/slideshow, billed at $0.03 per video minute plus $0.05 per 1,000 voiceover characters.

Turn listing photos into a vertical reel with one API call

Send the photo URLs and a script, and in under 30 seconds ReelSDK returns a 1080x1920 MP4 with every landscape photo shown whole over a blurred copy of itself.

Use casesUpdated

10 listing photos with a voiceover, music and karaoke captions, ready in under 30 seconds.Input: first listing photocaptions.srttranscript.json

The request

POST /v1/slideshow

Turn landscape listing photos into a vertical reel with a voiceover, music and captions, without cropping a single photo.

terminalTry it
curl "https://api.reelsdk.com/v1/slideshow?wait=300" \
  -H "Authorization: Bearer $REELSDK_KEY" \
  --json '{
    "images": [
      "https://api.reelsdk.com/f/lib/in/listing-villa/exterior.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/pool.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/living-room.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/fireplace.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/open-plan.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/kitchen.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/dining.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/bedroom.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/bathroom.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/garden.jpg"
    ],
    "size": "9:16",
    "fit": "contain",
    "voiceover": {
      "text": "Welcome to your next home. A modern villa with a private pool and a wide lawn that catches the sun all day. The living room opens onto the pool, with a fireplace for winter evenings. The kitchen is bright and fully fitted, and it flows into the dining area. The main bedroom is a quiet retreat with its own bathroom. Book a private viewing today, and see it for yourself.",
      "voice": "thalia"
    },
    "music": {
      "url": "https://api.reelsdk.com/f/lib/music/chill/calm-currents.mp3",
      "volume": 0.2
    },
    "captions": "karaoke"
  }'
request.mjsTry it
const res = await fetch("https://api.reelsdk.com/v1/slideshow?wait=300", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.REELSDK_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "images": [
      "https://api.reelsdk.com/f/lib/in/listing-villa/exterior.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/pool.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/living-room.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/fireplace.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/open-plan.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/kitchen.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/dining.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/bedroom.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/bathroom.jpg",
      "https://api.reelsdk.com/f/lib/in/listing-villa/garden.jpg"
    ],
    "size": "9:16",
    "fit": "contain",
    "voiceover": {
      "text": "Welcome to your next home. A modern villa with a private pool and a wide lawn that catches the sun all day. The living room opens onto the pool, with a fireplace for winter evenings. The kitchen is bright and fully fitted, and it flows into the dining area. The main bedroom is a quiet retreat with its own bathroom. Book a private viewing today, and see it for yourself.",
      "voice": "thalia"
    },
    "music": {
      "url": "https://api.reelsdk.com/f/lib/music/chill/calm-currents.mp3",
      "volume": 0.2
    },
    "captions": "karaoke"
  }),
});
const { job } = await res.json();
response.json
{
  "job": {
    "id": "job_8akcgi3s6l8p0nuigjlq",
    "op": "slideshow",
    "status": "succeeded",
    "stage": null,
    "created_at": "2026-11-07T01:23:53.469Z",
    "finished_at": "2026-11-07T01:24:19.212Z",
    "outputs": {
      "video": "https://api.reelsdk.com/f/out/job_8akcgi3s6l8p0nuigjlq/video.mp4?s=...",
      "transcript": "https://api.reelsdk.com/f/out/job_8akcgi3s6l8p0nuigjlq/transcript.json?s=...",
      "srt": "https://api.reelsdk.com/f/out/job_8akcgi3s6l8p0nuigjlq/captions.srt?s=...",
      "vtt": "https://api.reelsdk.com/f/out/job_8akcgi3s6l8p0nuigjlq/captions.vtt?s=...",
      "ass": "https://api.reelsdk.com/f/out/job_8akcgi3s6l8p0nuigjlq/captions.ass?s=..."
    },
    "result": null,
    "duration_s": 22.567,
    "error": null,
    "usage": {
      "output_seconds": 22.567,
      "audio_seconds": 22.056,
      "tts_characters": 371,
      "images": 0
    },
    "poll_url": "https://api.reelsdk.com/v1/jobs/job_8akcgi3s6l8p0nuigjlq"
  }
}

Why listing photos need the contain fit

Listing photos are landscape, while a 9:16 frame is tall at 1080x1920. If you leave fit at its default value of cover, the renderer scales each photo up to fill the whole vertical frame and crops the sides off, which cuts away most of a wide room.

Setting fit to contain keeps the whole photo visible instead. Each photo sits centred over a blurred, darkened copy of itself, so nothing gets cut off and you don't get plain black bars at the top and bottom. You change this behavior for all 10 photos in the request with that single fit field.

At a glance

What each field in the request did

What each field in the request did
FieldIn this requestWhat it does
images10 landscape photosOne slot per photo. With a voiceover and no seconds, the slots share the narration: a little over 2 seconds each here
size9:16Renders 1080x1920
fitcontainShows each whole photo, centred over a blurred, darkened copy of itself. The default, cover, crops to fill the frame
voiceoverA short listing script, voice thaliaText to speech in one of 40 English voices; the video runs half a second past the narration
musiccalm-currents.mp3 at volume 0.2Looped or trimmed to the video, faded out and ducked under the voice
captionskaraokePoppins at the bottom, 5 words per group, the spoken word highlighted

Sources: ReelSDK OpenAPI spec, ReelSDK slideshow docs, checked November 2026.

Timing follows the voiceover

When you leave out seconds_per_image, the photos split the narration evenly, and the video runs half a second past the end of the voiceover. Here a 22-second voiceover made a 23-second video, so each of the 10 photos got a little over 2 seconds.

You can still override the duration for a specific photo when you don't want an even split. Set seconds on an individual image object to hold the pool shot longer while the rest of the photos share the remaining time. The duration per image can be anywhere from 0.5 to 60 s.

One request per listing

You can trigger one POST /v1/slideshow call per new listing straight from your listing feed or CRM. One API key runs up to 3 jobs at once and up to 500 jobs per UTC day. Instead of holding the HTTP connection open while the video renders, pass a webhook_url in the payload to receive a signed POST as soon as the job finishes; see the webhooks docs for the payload format.

Output links expire after 7 days, so your webhook handler should copy the video to your own bucket. For per-minute and per-character rates, check pricing. This page is also en español.

What it costs

What this video cost

Video, 22.6 s at $0.03 per minute
$0.0113
Voiceover, 371 characters at $0.05 per 1,000
$0.0186
Total
$0.0298

Billed per second of output. A failed job costs nothing.

Limits

What one request takes

Images
1 to 100 per video
Seconds per image
0.5 to 60
Voiceover text
Up to 10,000 characters
Input files
500 MB each, 1 GB per job
Media length
Up to 15 minutes for captions and slideshows
Job run time
Up to 10 minutes
Concurrent jobs
3 per key
Jobs per day
500 per key
Output retention
7 days

How it works

From request to file

  1. Host the photos

    Pass 1 to 100 public https image URLs, or upload the files first with POST /v1/uploads. Input files can be up to 500 MB each and 1 GB per job.

  2. Write the voiceover from the listing

    Build a script up to 10,000 characters from the listing data and choose one of the 40 English voices.

  3. Send one POST /v1/slideshow

    Set size to 9:16 and fit to contain, and include either ?wait=300 on the request URL or a webhook_url in the body.

  4. Save the files

    Copy video.mp4 and captions.srt to your own storage before the output links expire after 7 days.

FAQ

Questions, answered

What does one listing video cost?

About 3 cents for a 10-photo reel with a short voiceover: $0.03 per minute of video plus $0.05 per 1,000 voiceover characters, and the voiceover is most of that. The $0.50 signup credit covers 2 videos like this one, because starting a job holds the most it can cost, about 47 cents, until it finishes.

Are the photos cropped?

Not when you set fit to contain, which shows every photo whole over a blurred, darkened copy of itself. The default cover mode fills the frame and crops whatever does not fit.

Can the voiceover be in Spanish or another language?

The built-in text to speech offers 40 English voices, so for another language you pass a URL to your own MP3 recording as the voiceover and set language so captions are transcribed in that language. There is also a Spanish version of this page.

How long does a render take?

Under 30 seconds for a reel like this one, from request to finished file. Add ?wait= to hold the request open for up to 300 s, or pass a webhook_url to get a POST when it is done.

Can I add the agency logo or the price on screen?

Yes, send the finished MP4 to POST /v1/ffmpeg in a second request using an overlay or drawtext filter. That call is billed at $0.02 per compute minute.

Ready to build?

Ship video from your app today

Your first $0.50 is free, and one key covers every endpoint.

Moonlit lake with a lit cabin under the mountains