v3
latestOpenAPI 3.1.02026-07-3197486526.1 KBembed > tasks
Create a video embedding task
<Note title="Note"> This endpoint will be deprecated in a future version. Migrate to the [Embed API v2](/v1.3/api-reference/create-embeddings-v2) for continued support and access to new features. </Note>This method creates a new video embedding task that uploads a video to the platform and creates one or multiple video embeddings.
<Note title="Note"> This endpoint is rate-limited. For details, see the [Rate limits](/v1.3/docs/get-started/rate-limits) page. </Note>Upload options:
- Local file: Use the video_file parameter
- Publicly accessible URL: Use the video_url parameter.
Specify at least one option. If both are provided, video_url takes precedence.
Your video files must meet the requirements. This endpoint allows you to upload files up to 2 GB in size. To upload larger files, use the Multipart Upload API
<Note title="Notes"> - The Marengo video understanding model generates embeddings for all modalities in the same latent space. This shared space enables any-to-any searches across different types of content. - Video embeddings are stored for seven days. </Note>post/embed/tasks
Headers
x-api-keystring required
Your API key.
<Note title="Note"> You can find your API key on the <a href="https://playground.twelvelabs.io/dashboard/api-keys" target="_blank">API Keys</a> page. </Note>Response
A video embedding task has successfully been created.