ReelSDK's POST /v1/slideshow turns photos into a TikTok-style slideshow with transitions and music at $0.03 per output minute. A 16-second slideshow costs under a cent, so the $0.50 free credit makes 62.

Make TikTok photo slideshows with music from one API call

Send the photo URLs, a track and a transition, named or random, and in under 20 seconds ReelSDK hands back a 1080x1920 MP4 ready to post.

Use casesUpdated

8 photos of Japan, 2 s each, with random transitions and a lofi track, ready in under 20 seconds.Input: first photo

The request

POST /v1/slideshow

Turn photos into a vertical TikTok-style slideshow with music and transitions, named or random, in one POST.

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/trips/kyoto-1.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/kyoto-2.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/kyoto-3.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/fuji.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-1.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-2.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-3.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-4.jpg"
    ],
    "size": "9:16",
    "seconds_per_image": 2,
    "transition": "random",
    "music": "https://api.reelsdk.com/f/lib/music/lofi/tokyo-sunset.mp3"
  }'
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/trips/kyoto-1.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/kyoto-2.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/kyoto-3.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/fuji.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-1.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-2.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-3.jpg",
      "https://api.reelsdk.com/f/lib/in/trips/tokyo-4.jpg"
    ],
    "size": "9:16",
    "seconds_per_image": 2,
    "transition": "random",
    "music": "https://api.reelsdk.com/f/lib/music/lofi/tokyo-sunset.mp3"
  }),
});
const { job } = await res.json();
response.json
{
  "job": {
    "id": "job_siv1jen0fisgmrinwar9",
    "op": "slideshow",
    "status": "succeeded",
    "stage": null,
    "created_at": "2026-11-07T01:31:37.457Z",
    "finished_at": "2026-11-07T01:31:55.340Z",
    "outputs": {
      "video": "https://api.reelsdk.com/f/out/job_siv1jen0fisgmrinwar9/video.mp4?s=..."
    },
    "result": null,
    "duration_s": 16,
    "error": null,
    "usage": {
      "output_seconds": 16,
      "audio_seconds": 0,
      "tts_characters": 0,
      "images": 0
    },
    "poll_url": "https://api.reelsdk.com/v1/jobs/job_siv1jen0fisgmrinwar9"
  }
}

What the random transition picks

Setting transition to random picks from a curated set of 12: fade, smoothleft, smoothright, smoothup, smoothdown, slideleft, slideright, slideup, slidedown, coverleft, coverright, and fadeblack. The API never uses the same one twice in a row. It seeds the sequence from the job id, so every job gets its own mix of cuts.

If you want the same transition on every cut, pass its name instead of random. The catalog has 58 named transitions in total. Set transition to none if you just want hard cuts between the photos.

At a glance

Transitions you can name

Set one for the whole slideshow with transition, or let random vary it per cut.

Transitions you can name
FamilyNames
Fadesfade, fadeblack, fadewhite, fadegrays, fadefast, fadeslow, dissolve
Wipeswipeleft, wiperight, wipeup, wipedown, wipetl, wipetr, wipebl, wipebr
Slidesslideleft, slideright, slideup, slidedown
Smoothsmoothleft, smoothright, smoothup, smoothdown
Cover and revealcoverleft, coverright, coverup, coverdown, revealleft, revealright, revealup, revealdown
Shapescirclecrop, rectcrop, circleopen, circleclose, vertopen, vertclose, horzopen, horzclose, radial
Diagonalsdiagtl, diagtr, diagbl, diagbr
Slices and windhlslice, hrslice, vuslice, vdslice, hlwind, hrwind, vuwind, vdwind
Effectsdistance, pixelize, hblur, squeezeh, squeezev, zoomin
Specialrandom picks from 12 of the above per cut; none makes hard cuts

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

Timing for a photo slideshow

8 photos at 2 s each produce a video that is 16 s long. Image slots run back to back, and each transition is centred on the cut, so transitions add no time to the output. You set the base duration with seconds_per_image from 0.5 to 60, and any single photo can carry its own seconds value if it needs to stay on screen longer.

The default transition is fade for 0.5 s. To change the duration, pass transition as an object with type and seconds, using any duration from 0.1 to 2 s.

Music and captions

This request uses the lofi track tokyo-sunset from the built-in library, which has 16 CC0 tracks in 8 moods by HoliznaCC0. You can also pass any MP3 URL you have the rights to use. The audio is looped or trimmed to match the video and faded out over the last 1 s.

Photo slideshows without speech do not generate captions. Captions need a voiceover, which you can set up in narrated slideshows. Full rates for rendering are on pricing.

What it costs

What this slideshow cost

Video, 16 s at $0.03 per minute
$0.0080
Total
$0.0080

No voiceover, so output seconds are the whole bill. A failed job costs nothing.

Limits

What one request takes

Images
1 to 100 per video
Seconds per image
0.5 to 60
Transition
0.1 to 2 s
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. Pick the photos

    Pass 1 to 100 public image URLs in the order they should play.

  2. Set the timing and transition

    Set seconds_per_image for the photos, and pick a transition name or random.

  3. Pick a track

    Pass a library track URL or your own MP3 URL in music.

  4. Send POST /v1/slideshow

    Call POST /v1/slideshow with ?wait=300 to get the finished 9:16 MP4 back on the same request, ready to post.

FAQ

Questions, answered

What does a 16-second slideshow cost?

Under a cent: 16 seconds of video at $0.03 per minute, with no voiceover. The $0.50 signup credit covers 62 videos like it.

Can I use my own music?

Yes. The music field takes any public MP3 URL, or you can use one of the 16 CC0 tracks in the built-in library.

Can I put text on the photos?

Captions come from a voiceover. For on-screen text without one, send the finished MP4 to POST /v1/ffmpeg with a drawtext filter.

How long does a render take?

Under 20 seconds for a 16-second slideshow like this one, from request to finished file.

Can each cut use a different transition?

One named transition applies to every cut in the video. Setting it to random varies the transition per cut from a pool of 12 transitions, and never picks the same one twice in a row.

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