Examples
Each example here is one question somebody actually asks, the call that answers it, and what comes back. They are written to be copied — the parameters shown are the parameters to send, not a simplified version of them.
Last updated
Every example
Each one is a page: the question, the call in three or four surfaces, what comes back, and the part people get wrong the first time.
| The question | Example |
|---|---|
| Where are all the cuts in this video, and how fast is it cut? | How to find every cut in a video, with timestamps |
| What does the caption at 0:37 say, and how is it set? | How to read on-screen text at a given second |
| Why does this ad work, and what is the hook? | How to analyse a competitor ad from Meta Ads |
| Is there anything broken in this export? | How to QA a render before it ships |
| What was on screen while they said the price? | How to align a transcript to what is on screen |
| How do I survey a two-hour recording from a backend job? | How to analyse a long video asynchronously |
| The API refused my window. What now? | How to recover when a call is refused |
- How to find every cut in a video, with timestampsGet scene cuts as a list of seconds, plus pacing — segment count, median segment length and cuts per minute — from one call.
- How to read on-screen text at a given secondPull one frame at full resolution to read a caption, a price, a legal disclaimer or a typeface that is illegible on a contact sheet.
- How to analyse a competitor ad from Meta AdsTake a running ad apart: the hook, the beats, the on-screen claims and when each appears — from the ad library URL, no download required.
- How to QA a render before it shipsCheck an export for black frames, freezes, audio dropouts and silence in one pass, against a spec rather than by eye.
- How to align a transcript to what is on screenGet word-level timings and match them against frame times, so you can say what was being said while something was shown.
- How to analyse a long video asynchronouslyQueue the work, get a job id back immediately, and poll or receive a webhook when it settles.
- How to recover when a call is refusedErrors carry a suggestion object holding the exact call that would have worked. Spread it back into the retry.
Where to go from here
Examples show a shape. Three other pages explain why the shape is that way.
- Detail levels — why looking closer means fewer frames per sheet rather than a bigger image, and how to pick a level from a question.
- REST API reference — every parameter, every response field, and what each one is for.
- Playbooks — full written methods for jobs that recur, rather than single calls.