Video breakdown
LiveUpload a video up to 120 seconds. Get every shot with its time range and frames, what happens, the turning point and the ending, and what to keep when you remake it.
Break down video
Turn a video into a shot-by-shot report with timestamped frames.
Paid per run · video up to 120 seconds · 3 analyses per hour
Files are processed privately and are not published. Analysis sends selected media to an AI model; temporary source files are removed afterward.
Open image generation and editingAPI endpoint
POST /v1/media/video-breakdownAuthenticate with an API key. Download accepts JSON with url and optional max_height; inspection accepts multipart file. Keys stay in memory.
Example outputA real run on a Creative Commons trailer. Use your own link or file to replace it.
Big Buck Bunny trailer (CC) Blender Foundation | www.bigbuckbunny.org — CC BY 3.0, via Wikimedia Commons
How it works
- 01Add a videoUpload a clip up to 120 seconds, or download one from a link first.
- 02Get the reportEvery shot with its time range, frames and what happens in it.
- 03Check and reuseClick a frame to jump to that moment, see flagged details and save the report as JSON.
Call Video breakdown from your code
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/Get an API key
Create a key in the console. It uses the same balance as the playground.
Create a keySend your first request
The same request the playground sends. Set OPENNAN_KEY to your key.
curl https://api.opennan.com/v1/media/video-breakdown \ -H "Authorization: Bearer $OPENNAN_KEY" \ -F "[email protected]"Read the result
The result comes back in the same response. The X-Usage-Cost-Usd header says what the call cost.
Errors and how to fix them
401Missing or wrong key
Send the header Authorization: Bearer with a key from the console.
402Balance too low
Add credit in Billing, then send the same call again.
400A value is not accepted
Read error.message: it names the field. Use a value from the parameter table.
429Too many requests
Wait a few seconds and try again, waiting longer after each 429.
Video breakdown: questions
How much does Video breakdown cost?
You pay for the AI tokens each run uses. The most a run can cost is held from your balance first and the rest goes back. A run that fails before the AI reads your file is not charged; once the AI has read it, the tokens it used are charged even if the run then fails.
How do I call it from my code?
Send POST https://api.opennan.com/v1/media/video-breakdown with your API key. The result comes back in the same response.
Can my AI agent use it?
Yes. Point your agent at https://api.opennan.com/llms.txt: it explains this endpoint and every other one.
What happens if a run fails?
A request that fails is not charged. You pay only for the tokens used.