Images to Video API
Turn photos into a slideshow video with transitions, Ken Burns motion, captions and a music track.
Environment
| Environment | Base URL |
|---|---|
| Production | https://api.sadafiles.com/v1 |
There is one environment and no sandbox, so every request here is real and counts toward your limits.
Request
POSThttps://api.sadafiles.com/v1/tools/images-to-video
- Content type
- multipart/form-data
- Auth
- X-API-Key with tools:run
- Accepts
- jpg, png, webp, avif, gif, bmp, tiff, heic and 1 more
- Files per request
- 2 to 200
- Largest file
- 2 GB
- Job timeout
- 600 s
- Rate weight
- 2 units
- Web tool
- Use Images to Video without code
Parameters
Send these as a JSON string in the options form field. Anything else is rejected.
| Name | Type | Default | Allowed |
|---|---|---|---|
slideSeconds | number | 3 | min 1, max 10, s |
transition | string | fade | none, fade, slide-left, zoom, wipe |
kenBurnsSlow pan and zoom on each still. | boolean | true | — |
aspectPortrait 4:5 and 9:16 suit Instagram and Reels; 16:9 suits YouTube and slides. | string | 16:9 | 16:9, 9:16, 1:1, 4:5 |
fit | string | blur-pad | cover, contain, blur-pad |
resolution | string | 1080p | 720p, 1080p |
fps | integer | 30 | 24, 30 |
captionsOne line per photo, in order; leave a line blank for no caption. | string | — | — |
audioOptional MP3, WAV or M4A; trimmed or looped to the video length. | string | — | — |
format | string | mp4 | mp4, webm |
Response
| Status | Body | When |
|---|---|---|
201 | mp4, webm | The run finished within 60 seconds |
202 | Job summary JSON | Still running; poll the job |
4xx, 5xx | Error JSON | See error codes |
A file response carries X-Sada-Job and X-Sada-Expires-At. For long work, post to /v1/tools/images-to-video/jobs instead. See jobs and webhooks.
Try it yourself!
Pick a file, set the options and run a real request with your key. The code follows your changes.