When providing content to the platform, you can upload it as a reusable asset or pass it inline. For embeddings and video analysis, you also choose a processing mode based on the duration of your file.

Upload methods

You can provide content to the platform in two ways:

When providing a URL, use direct links to raw media files. Video hosting platforms and cloud storage sharing links are not supported.

Assets

When you upload content as an asset, you can use one of the following methods:

Direct uploads are processed asynchronously. Every upload returns status: processing; poll the status of the asset until it is ready before you use the asset.

Use multipart uploads for larger local video files.

The limits above apply when you upload an asset. Each model applies its own file size and duration limits when you index or analyze the asset. For details, see the Marengo and Pegasus requirements.

Inline

Provide content inline in the request for one-time embedding generation. You cannot reuse this content across multiple operations.

Processing modes

Choose a processing mode based on the type and duration of your content. Both modes support all input methods (asset ID, URL, and base64).

Analyze videos

The synchronous mode returns results immediately. The asynchronous mode creates an analysis task that you poll until processing completes. Streaming responses are only available with the synchronous mode.

Create embeddings

The synchronous mode returns results immediately. The asynchronous mode creates an embedding task that you poll until processing completes.

Search content

To search content, upload your files as assets.