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.
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.
When you upload content as an asset, you can use one of the following methods:
For direct uploads with public URLs, files under 200 MB return status: ready. Files over 200 MB return status: processing.
Use multipart uploads for larger local video files.
Provide content inline in the request for one-time embedding generation. You cannot reuse this content across multiple operations.
Choose a processing mode based on the type and duration of your content. Both modes support all input methods (asset ID, URL, and base64).
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.
The synchronous mode returns results immediately. The asynchronous mode creates an embedding task that you poll until processing completes.
To search content, upload your files as assets.