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

8 photos of a pickup with a voiceover and bold captions at the bottom, ready in under 30 seconds.Input: first listing photocaptions.srttranscript.json

The request

POST /v1/slideshow

Auto-generate a vertical video with voiceover and captions for every vehicle in your inventory from its listing photos.

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-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"
    }
  }'
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-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();
response.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.

Inventory videos at this run's size
VehiclesVideoCost
1 vehicle, the sample22 sabout 2.5 cents
100 vehiclesabout 36 minutesabout $2.50
500 vehicles, one key's daily capabout 3 hoursabout $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

  1. Collect the listing photos

    Pass the public photo URLs straight from your inventory feed, or upload local files first with POST /v1/uploads.

  2. 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.

  3. POST /v1/slideshow with an Idempotency-Key

    Send the VIN in the Idempotency-Key header so a retried import within 24 h gets the same job back without rendering twice.

  4. Attach the video to the listing

    Download video.mp4 to 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.

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