When providing content to the platform, you can upload or import 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 or import 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 and audio files.

The limits above apply when you upload or import content. Each model applies its own file size and duration limits. 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 or import your files as assets.