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
The request
POST /v1/slideshow
Turn landscape listing photos into a vertical reel with a voiceover, music and captions, without cropping a single photo.
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"
}'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();{
"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
| Field | In this request | What it does |
|---|---|---|
images | 10 landscape photos | One slot per photo. With a voiceover and no seconds, the slots share the narration: a little over 2 seconds each here |
size | 9:16 | Renders 1080x1920 |
fit | contain | Shows each whole photo, centred over a blurred, darkened copy of itself. The default, cover, crops to fill the frame |
voiceover | A short listing script, voice thalia | Text to speech in one of 40 English voices; the video runs half a second past the narration |
music | calm-currents.mp3 at volume 0.2 | Looped or trimmed to the video, faded out and ducked under the voice |
captions | karaoke | Poppins 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
Host the photos
Pass 1 to 100 public
httpsimage URLs, or upload the files first withPOST /v1/uploads. Input files can be up to 500 MB each and 1 GB per job.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.
Send one POST /v1/slideshow
Set
sizeto9:16andfittocontain, and include either?wait=300on the request URL or awebhook_urlin the body.Save the files
Copy
video.mp4andcaptions.srtto 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.
- Vídeos inmobiliariosConvierte las fotos horizontales de un anuncio en un vídeo vertical con locución, música y subtítulos, sin recortar ninguna foto.
- Car dealer inventory videosAuto-generate a vertical video with voiceover and captions for every vehicle in your inventory from its listing photos.
- Narrated slideshow APISend images and a script; get back a video narrated in one of 40 voices, with captions and music under the voice.
- Bulk video generationTurn every row of a spreadsheet into its own personalized video with a short Node script and one POST per row.
- Slideshow API: photos to a narrated video for $0.03 a minuteSend 1 to 100 photo URLs and get an MP4 with Ken Burns motion, transitions, an AI voiceover, music and captions. $0.03 per output minute, plus $0.05 per 1,000 voiceover characters.
- Slideshow API reference: POST /v1/slideshowPOST /v1/slideshow turns 1 to 100 photos into an MP4 up to 15 minutes: 40 voices, music ducking, captions, 58 transitions and Ken Burns motion. Full parameter reference.
Ready to build?
Ship video from your app today
Your first $0.50 is free, and one key covers every endpoint.
