Upload methods

This page describes the methods for uploading content to the platform for search, analysis, and embedding operations.

Overview

You can provide content to the platform in two ways:

MethodDescriptionUse for
AssetsCreates a reusable resource with a unique identifier. You can reference your assets across multiple operations.Search, analysis, and embeddings
InlineProvides content inline through a URL or base64-encoded data. You cannot reuse this contentEmbeddings

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:

MethodLimitReference
Direct uploads- Local files: Up to 200 MB
- URLs: Up to 4 GB
Python SDK | Node.js SDK | API Reference
Multipart uploadsLocal files: Up to 4 GBPython 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.

MethodSize limit
URL4 GB
Base6436 MB for video and audio, 5 MB for images

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.

Processing modes

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

ModeContent typeLimitReference
SyncVideo, audioUp to 10 minutesPython SDK | Node.js SDK | API Reference
SyncImagesUp to 5 MBPython SDK | Node.js SDK | API Reference
AsyncVideo, audio10 minutes to 4 hoursPython SDK | Node.js SDK | API Reference