> ## Documentation Index
> Fetch the complete documentation index at: https://fal.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Video understanding and media download

> Ask fal Agent questions about a video with timestamps, and bring public media from YouTube, TikTok, or X into the chat.

## Understand a video

Attach a video, or refer to one in the chat, and ask a question. The agent watches the video and answers with timestamps.

```text theme={null}
Watch the hallway clip. Where does the product first appear, and does the logo stay readable?
```

Typical uses:

* **Review a generation.** Check continuity, motion quality, and whether the prompt was followed.
* **Find a moment.** Get the timestamp of a shot to trim, extend, or reference.
* **Describe a reference.** Turn an uploaded reference video into a shot list before recreating it.

You can narrow the question to a window, such as "between 0:10 and 0:25". A broad question on a long video takes several minutes.

| Limit            | Value                                                 |
| :--------------- | :---------------------------------------------------- |
| Video size       | 250 MB                                                |
| Source           | Videos hosted on fal. Uploads and generations qualify |
| Analysis timeout | 4 minutes                                             |

## Download media

Give the agent a public link to a video, image, or audio file. The agent brings the file onto fal. You can then use it as a reference, an edit source, or a clip in a [video sequence](/docs/documentation/agent/tools/video-sequences).

```text theme={null}
Download this and use the first 3 seconds as the opening shot: https://www.youtube.com/watch?v=...
```

| Supported        | Notes                                          |
| :--------------- | :--------------------------------------------- |
| YouTube          | Public videos                                  |
| TikTok           | Public videos                                  |
| X (Twitter)      | Public posts with media                        |
| Direct file URLs | Any public `.mp4`, `.png`, `.mp3`, and similar |

Sites that require a login, such as Instagram and private posts, are not supported.

| Limit            | Value       |
| :--------------- | :---------- |
| File size        | 500 MB      |
| Video resolution | Up to 1080p |
| Download timeout | 3 minutes   |

Downloaded files are saved to your [Assets](/docs/documentation/agent/assets-and-characters) like any other input.