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
The request
POST /v1/slideshow
Turn photos into a vertical TikTok-style slideshow with music and transitions, named or random, in one POST.
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"
}'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();{
"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.
| Family | Names |
|---|---|
| Fades | fade, fadeblack, fadewhite, fadegrays, fadefast, fadeslow, dissolve |
| Wipes | wipeleft, wiperight, wipeup, wipedown, wipetl, wipetr, wipebl, wipebr |
| Slides | slideleft, slideright, slideup, slidedown |
| Smooth | smoothleft, smoothright, smoothup, smoothdown |
| Cover and reveal | coverleft, coverright, coverup, coverdown, revealleft, revealright, revealup, revealdown |
| Shapes | circlecrop, rectcrop, circleopen, circleclose, vertopen, vertclose, horzopen, horzclose, radial |
| Diagonals | diagtl, diagtr, diagbl, diagbr |
| Slices and wind | hlslice, hrslice, vuslice, vdslice, hlwind, hrwind, vuwind, vdwind |
| Effects | distance, pixelize, hblur, squeezeh, squeezev, zoomin |
| Special | random 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
Pick the photos
Pass 1 to 100 public image URLs in the order they should play.
Set the timing and transition
Set
seconds_per_imagefor the photos, and pick a transition name orrandom.Pick a track
Pass a library track URL or your own MP3 URL in
music.Send POST /v1/slideshow
Call
POST /v1/slideshowwith?wait=300to get the finished9:16MP4 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.
- Narrated slideshow APISend images and a script; get back a video narrated in one of 40 voices, with captions and music under the voice.
- Product videos from photosTurn ecommerce product photos into a short video with slide transitions and music, in any feed shape, with one POST.
- TikTok captions APIBurn TikTok-style word-by-word captions into a video with one POST and get SRT, VTT and a word-timed transcript back.
- 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.
- Best program for a slideshowFree slideshow programs compared by watermark, export quality and device: Canva, iMovie, Clipchamp, Google Photos and a no-signup maker.
- Is faceless video free?Which faceless video makers have free plans, what the free tiers leave out, and what the cheapest paid plans cost.
- Do AI videos make money?What YouTube and TikTok pay AI-made videos, which AI content they refuse to monetize, and what making the shorts costs.
- Best free AI video generatorFree AI video generators compared by what you actually get free: VideoGPT, Runway, Kling, Pika, HeyGen, Luma and Gemini.
Sources, checked November 2026
Ready to build?
Ship video from your app today
Your first $0.50 is free, and one key covers every endpoint.
