ViddyFlow documentation

Everything ViddyFlow does, from your first job to driving the whole pipeline over the API.

What ViddyFlow is

ViddyFlow watches a livestream VOD the way a video editor would, then cuts it up for you. It analyses the video, the audio and the chat, and scores every part of the stream on how worth keeping it is. The moments that win become a long-form highlight reel and a batch of vertical shorts for TikTok, YouTube Shorts and Reels.

You never touch a timeline. Captions, titles, descriptions, tags, thumbnails and chapter markers are generated with the clips.

How a job works

  1. You point it at a stream. A public Twitch VOD URL, or an MP4 or MOV you upload.
  2. It watches and scores. Video, audio and chat combine into one score per moment.
  3. It picks the best moments. A highlight profile decides what "best" means: balanced, chat-reaction led, or streamer led.
  4. It renders. A highlight reel at the length you asked for, plus vertical shorts framed however you chose.
  5. You collect. Download individually or as one ZIP from the app, or get the links pushed to your own system with a webhook if you are building on the API.

A typical job takes a few minutes per hour of source video, depending on the processing tier you pick.

Find what you need

Getting startedCreate an account, run your first job, and find your output.Creating a jobSources, highlight profiles, reel length, teaser intro and clip length.Vertical shortsHow many, the four framing modes, captions and title cards.Music and brandingBackground tracks, intro and outro clips, and the plan limits on both.Your resultsEvery file a job produces, how to download it, and how long it is kept.Credits and plansWhat a job costs, what each plan unlocks, and when credits come back.Account and securityProfile, email preferences, sessions, your data and account deletion.API referenceEvery endpoint and field reachable with an API key.WebhooksGet pushed job updates instead of polling, and verify they are genuine.

In a hurry

If you just want clips out of a stream today, read Getting started and stop there. Everything else is detail you can come back for.

If you are wiring ViddyFlow into your own tooling, go straight to the API reference and Webhooks.