openclip-thumbnails

Upload the video with create_upload, PUT the bytes to the returned upload_url, then call extract_thumbnails with the upload id. Poll get_tool_job_status until the job completes and receive a zip of frames hosted on permanent CDN URLs.

First trim the video to that moment using edit_video with operation trim and the target start_ms and end_ms, then run extract_thumbnails on the trimmed output. This gives you the frame from the precise moment rather than an even spread.

No, extract_thumbnails always returns a zip archive of frames, never individual image URLs. You can hand the zip URL to the user or unpack it to pick a specific frame.

Yes, both extract_thumbnails and edit_image are free with an OpenClip account, requiring no subscription and no credits. Free usage is rate limited per day with a per-file size cap.

No, edit_image accepts exactly one operation per call: compress, resize, or crop. To resize and then compress, run two sequential calls, each with its own job polling cycle.

Both tools are asynchronous and return a tool_job id with status queued. Poll get_tool_job_status every 5 to 10 seconds until it reaches completed with output URLs or failed with an error message.