ReelSDK turns a car's listing photos into a vertical video with voiceover, music and captions through POST /v1/slideshow. An 8-photo video costs about 2.5 cents, at $0.03 per minute of video and $0.05 per 1,000 characters read aloud.
Auto-generate an inventory video for every car listing
One request per vehicle returns a 1080x1920 MP4 in under 30 seconds with no part of the car cropped, and a single ReelSDK key handles 500 vehicles per UTC day.
Use casesUpdated
The request
POST /v1/slideshow
Auto-generate a vertical video with voiceover and captions for every vehicle in your inventory from its listing photos.
curl "https://api.reelsdk.com/v1/slideshow?wait=300" \
-H "Authorization: Bearer $REELSDK_KEY" \
--json '{
"images": [
"https://api.reelsdk.com/f/lib/in/listing-pickup/front-quarter.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/front.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/side.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/rear-quarter.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/tailgate.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/dashboard.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/front-seats.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/rear-seats.jpg"
],
"size": "9:16",
"fit": "contain",
"voiceover": {
"text": "Just in on the lot: a black full-size pickup, ready for work and for the weekend. It sits tall on all-terrain tires, with a deep bed for whatever you need to haul. Inside, there'\''s a large touchscreen and plenty of room in both rows. Book a test drive today, and take it home this week.",
"voice": "orion"
},
"music": {
"url": "https://api.reelsdk.com/f/lib/music/upbeat/funky-pop.mp3",
"volume": 0.15
},
"captions": {
"preset": "bold",
"position": "bottom"
}
}'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-pickup/front-quarter.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/front.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/side.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/rear-quarter.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/tailgate.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/dashboard.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/front-seats.jpg",
"https://api.reelsdk.com/f/lib/in/listing-pickup/rear-seats.jpg"
],
"size": "9:16",
"fit": "contain",
"voiceover": {
"text": "Just in on the lot: a black full-size pickup, ready for work and for the weekend. It sits tall on all-terrain tires, with a deep bed for whatever you need to haul. Inside, there's a large touchscreen and plenty of room in both rows. Book a test drive today, and take it home this week.",
"voice": "orion"
},
"music": {
"url": "https://api.reelsdk.com/f/lib/music/upbeat/funky-pop.mp3",
"volume": 0.15
},
"captions": {
"preset": "bold",
"position": "bottom"
}
}),
});
const { job } = await res.json();{
"job": {
"id": "job_5vmx3ofdp7vsf2stmb1n",
"op": "slideshow",
"status": "succeeded",
"stage": null,
"created_at": "2026-11-07T01:31:37.398Z",
"finished_at": "2026-11-07T01:32:06.642Z",
"outputs": {
"video": "https://api.reelsdk.com/f/out/job_5vmx3ofdp7vsf2stmb1n/video.mp4?s=...",
"transcript": "https://api.reelsdk.com/f/out/job_5vmx3ofdp7vsf2stmb1n/transcript.json?s=...",
"srt": "https://api.reelsdk.com/f/out/job_5vmx3ofdp7vsf2stmb1n/captions.srt?s=...",
"vtt": "https://api.reelsdk.com/f/out/job_5vmx3ofdp7vsf2stmb1n/captions.vtt?s=...",
"ass": "https://api.reelsdk.com/f/out/job_5vmx3ofdp7vsf2stmb1n/captions.ass?s=..."
},
"result": null,
"duration_s": 21.7,
"error": null,
"usage": {
"output_seconds": 21.7,
"audio_seconds": 21.192,
"tts_characters": 285,
"images": 0
},
"poll_url": "https://api.reelsdk.com/v1/jobs/job_5vmx3ofdp7vsf2stmb1n"
}
}
Wide car photos in a tall frame
Side and three-quarter shots of a car are wide. In a 9:16 frame (1080x1920), the default fit value, cover, crops each photo to fill the frame and cuts off the nose and the tail. Setting fit to contain shows the whole car centred over a blurred, darkened copy of the same photo.
When you include a voiceover and leave out seconds_per_image, the images share the narration evenly. Here a 21-second voiceover made a 22-second video, since the video runs half a second past the narration, so each of the 8 photos got a little under 3 seconds on screen.
At a glance
Inventory videos at this run's size
Each vehicle with 8 photos and a script about as long as the sample's.
| Vehicles | Video | Cost |
|---|---|---|
| 1 vehicle, the sample | 22 s | about 2.5 cents |
| 100 vehicles | about 36 minutes | about $2.50 |
| 500 vehicles, one key's daily cap | about 3 hours | about $12.50 |
Sources: Sample run, ReelSDK pricing, checked November 2026.
Output seconds at $0.03 per minute plus voiceover at $0.05 per 1,000 characters. Each job is billed on its own length.
Captions that stay off the car
The bold caption preset renders uppercase Montserrat at 3 words per group with the spoken word highlighted. By default it sits in the middle of the frame, right over the car.
Set position to bottom to move the captions under the car so the bodywork stays clear. If you want to adjust how the text fits the lower third, max_words takes 1 to 8 words per group and size scales the font from 0.5 to 2.
Wiring it to your inventory feed
Send one POST /v1/slideshow request per new vehicle in your feed. Put the VIN in the Idempotency-Key header. A key of 8 to 128 characters is replayed for 24 h, so a re-run import within 24 h gets the existing job back instead of rendering the same car twice.
An API key runs 3 jobs at once and 500 jobs per UTC day. Past those limits the API responds with 429 RATE_LIMITED and a Retry-After header so your worker knows when to resume. See the jobs docs, pricing and bulk generation pages for queue setup and volume details.
What it costs
What this video cost
- Video, 21.7 s at $0.03 per minute
- $0.0109
- Voiceover, 285 characters at $0.05 per 1,000
- $0.0143
- Total
- $0.0251
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
Collect the listing photos
Pass the public photo URLs straight from your inventory feed, or upload local files first with
POST /v1/uploads.Write the script from the vehicle fields
Build a voiceover string up to 10,000 characters from the vehicle's listing fields and pick one of the 40 English voices.
POST /v1/slideshow with an Idempotency-Key
Send the VIN in the
Idempotency-Keyheader so a retried import within 24 h gets the same job back without rendering twice.Attach the video to the listing
Download
video.mp4to your own storage or CDN, since output links expire after 7 days.
FAQ
Questions, answered
What does a video per car cost?
About 2.5 cents for an 8-photo video 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. 100 cars come to about $2.50, and the $0.50 signup credit covers 2 videos like this one, because starting a job holds the most it can cost, about 46 cents, until it finishes.
Will the photos be cropped?
Not when you set fit to contain, which shows each photo whole over a blurred copy of itself. The default setting, cover, crops the image to fill the frame.
Which voice is that?
It uses orion, one of the 40 built-in English text to speech voices. You can also pass your own recording as an MP3 URL.
How long does a render take?
Under 30 seconds for a car like this one, from request to finished file. You can pass ?wait= to hold the request open for up to 300 s, or set a webhook_url to get a signed POST when it finishes.
Can I put the price and mileage on screen?
Yes, send the finished MP4 to POST /v1/ffmpeg with a drawtext filter, billed at $0.02 per compute minute.
- Real estate listing videosTurn landscape listing photos into a vertical reel with a voiceover, music and captions, without cropping a single photo.
- Bulk video generationTurn every row of a spreadsheet into its own personalized video with a short Node script and one POST per row.
- Product videos from photosTurn ecommerce product photos into a short video with slide transitions and music, in any feed shape, with one POST.
- 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.
- Jobs: statuses, waiting and pollingHow ReelSDK jobs work: 4 statuses, 12 job fields, GET /v1/jobs/{id}, waits of up to 300 s with ?wait or Prefer, 202 with Retry-After: 5 and polling code in curl, JavaScript and Python.
Ready to build?
Ship video from your app today
Your first $0.50 is free, and one key covers every endpoint.
