Pull still frames from an AI video: Sume video-frames, at or fps
POST /v1/video-frames returns images at exact timestamps or at up to 2 fps. Request shape, the ready poll, and limits for a clip up to 300 seconds.
To get a still from a generated video, call POST /v1/video-frames with a list of timestamps in at. Each frame comes back with its time, a URL, and width and height. Use it for thumbnails, for checking a model's output at second 3, or as the first frame of a follow-up clip.
Two ways to choose frames
The job is asynchronous. Poll GET /v1/video-frames/{id} until resource_status is ready, then read the frames array.
| Option | Rule |
|---|---|
| at | 1 to 24 values; each at least 0 and below the clip duration |
| fps | Up to 2 frames per second |
| Source | Up to 300 seconds |
Gotchas
Job results and artifact links are described on the jobs and results page.
- A timestamp equal to the duration is rejected; use duration minus a small step for the last frame.
- Send a workspace artifact URL, the media.sume.com link from the job result, not a download link from the video endpoint.
- Do not store the frame URLs as permanent links without checking the retention rules in the docs.
Sources
Related posts
More in Media tools
- Spotify podcast transcript upload: VTT, 5MB and Sume STT parts
Spotify takes VTT or SRT up to 5MB, with timestamps. Build one from Sume STT in 10-minute parts, stitch the cues, and upload from Spotify for Creators.
- SRT or WebVTT? What Vimeo, Spotify, Apple and Cloudflare accept
Vimeo, Spotify and Apple Podcasts take SRT or WebVTT; Cloudflare Stream documents WebVTT. A table read 2026-10-03 and a script writing both from Sume segments.
- Swap the model in a clothing video with AI: H3 Max Recast
Recast swaps the person in a clip for a person from a photo, 5 to 30 seconds. What it keeps, what the docs leave open about the garment, and the Sume call.
- Trim a clip to 10 seconds before a Gemini Omni edit
Google caps Omni edit and extend inputs at 10 seconds. Cut longer footage first with Sume's video-trim endpoint, a flat $0.02 per job.
Written by Sume