analyze_video breaks down a clip; it does not QC a prompt match

Frames, beats, on-screen text, and transcript — from one video. Get feedback on a video is analyze_video: deep, on-demand understanding of a clip you point at. Sample frames uploaded as reusable JPEGs, style and per-timestamp beats, on-screen type, optional speech. It is not a prompt-adherence QC, and it is not "why is this TikTok viral." Using it as a self-grade against the prompt you typed, or running it on every generate "just in case," spends an analysis pass you did not need — and still does not answer "does this match what I asked."

Required: video_url. Optional depth, include_transcript, focus. Priced as an analysis pass. It is deeper than the short note automatic attachment preprocessing injects. Prefer it over guessing from a URL when you need frames as references for an image edit, a workflow asset, or a recreation.

Breakdown vs verdict vs trend

"Analyze this video and describe what happens, beat by beat." "Pull frames I can use as reference images, and transcribe the speech." That is this page.

"Does this generation match the prompt?" is get AI feedback on a generation — review_generation, with matches/issues/severity/fix. Versely does not auto-run that after every generate because of extra cost and latency. Ask when you are actually unsure.

"Why is this Reel going viral?" is analyze a viral video or post. Different input (a social link), different output (hook and strategy). Dumping a competitor URL into analyze_video still gets you beats and frames. It does not get you the trend read.

Do not use this as a captioner. Optional transcript is a convenience inside the breakdown. If you only needed words, transcribe audio to text. If you needed burned captions, that is the caption job.

Spend the pass on a keeper

Analysis on a take you already know you will regen is a note about a file you will delete. Run it when the clip might be the reference, the recreation source, or the thing you will brief a recut from. The extracted frames are the reusable part; treat them that way.

FAQ

Will analyze_video tell me if my generate missed the prompt?

Not as its job. That is review_generation on get AI feedback on a generation. This job describes what is on screen.

Should I run it after every clip?

No. It costs an analysis pass. Use it when you need frames, beats, or a transcript from this file, not as a default footer on generate.

Can I skip analyze_video and describe the video from memory?

You can. You will mis-brief the recreation. The tool exists so you do not guess timestamps and on-screen type from a URL.

Does it caption the file?

No. Optional transcript is text. Burned captions are a different capability.