This page describes the methods for uploading content and the processing modes available for embedding operations.

Upload methods

You can provide content to the platform in two ways:

Method	Description	Use for
Assets	Creates a reusable resource with a unique identifier. You can reference your assets across multiple operations.	Search, analysis, and embeddings
Inline	Provides content inline through a URL or base64-encoded data. You cannot reuse this content	Embeddings

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:

Method	Limit	Reference
Direct uploads	- Local files: Up to 200 MB - URLs: Up to 4 GB	Python SDK \| Node.js SDK \| API Reference
Multipart uploads	Local files: Up to 4 GB	Python SDK \| Node.js SDK \| API Reference

Inline

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

Method	Size limit
URL	4 GB
Base64	36 MB for video and audio, 5 MB for images

Processing modes

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

Mode	Content type	Limit	Reference
Sync	Video, audio	Up to 10 minutes	Python SDK \| Node.js SDK \| API Reference
Sync	Images	Up to 5 MB	Python SDK \| Node.js SDK \| API Reference
Async	Video, audio	10 minutes to 4 hours	Python SDK \| Node.js SDK \| API Reference

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

Search or analyze content

To search or analyze content, upload your files as assets.

Create embeddings

You can provide content for embeddings as assets or inline in the request. Choose a processing mode based on the duration of your content.