Visual Search

Visual search lets you find clips by describing what's happening on screen. It's like having someone who has watched every second of every video in your library and can instantly recall any moment you describe.

How It Works

When your videos were uploaded, StarZero Agents studied every shot — what objects are visible, what people are doing, where the action takes place, and more. When you describe what you're looking for, it finds the shots that match.

Example Queries

Here are some examples of the kinds of things you can find with visual search:

• "Find clips with a yellow car driving on a forest road"
• "Show moments where two people shake hands"
• "Find shots of a sunset over the ocean"
• "Show clips with someone writing on a whiteboard"
• "Find close-up shots of food being prepared"
• "Show me any clips filmed in a conference room"
• "Find shots where someone is walking through a city at night"

The key is to describe what someone would literally see if they were watching the video.

Tips for Better Results

Be Specific About What's Visible

The more detail you include, the more accurate your results will be. Instead of "find clips outside", try "find clips of people walking through a park with trees in the background".

Describe Objects, Actions, and Settings

Think about three things: what is in the shot, what it's doing, and where it's happening.

• Objects: a laptop, a microphone, a dog, a blue banner
• Actions: running, talking, pointing at a screen, pouring water
• Settings: in a studio, on a stage, at a desk, outdoors in a field

Add Helpful Details

Small additions can make a big difference:

• Time of day: "at night", "during golden hour"
• Camera framing: "close-up", "wide shot", "overhead angle"
• Environment: "indoors", "outdoors", "in a crowd", "in an empty room"

Stick to Observable Facts

Visual search works best with things you can objectively see.

What Visual Search Can't Do

Visual search is not able to understand subjective visual qualities. Queries like these won't work well:

• "Find the most beautiful shot" — beauty is subjective
• "Show the most cinematic angle" — style is interpretive
• "Find the most dramatic moment" — drama is a judgment call

For subjective or interpretive queries like these, use Analysis instead, where StarZero Agents can apply creative judgment.

Reviewing Your Results

Results come back as ranked clips with relevancy scores. Each result includes a looping video preview so you can quickly confirm it matches what you had in mind. From there, you can tell StarZero Agents which clips to keep, ask for more results, or refine your search with a follow-up message.