The Embed.V2.Tasks interface provides methods to create embeddings asynchronously for audio and video content. Use this class for processing files longer than 10 minutes.

When to use this interface:

• Process audio or video files longer than 10 minutes
• Process files up to 4 hours in duration

Creating embeddings asynchronously requires three steps:

1. Create a task using the create method. The platform returns a task ID.
2. Poll for the status of the task using the retrieve method. Wait until the status is ready.
3. Retrieve the embeddings from the response when the status is ready using the retrieve method.

Methods

List embedding tasks

Description: This method returns a list of the async embedding tasks in your account. The platform returns your async embedding tasks sorted by creation date, with the newest at the top of the list.

Function signature and example:

1
list(
2
    request?: TwelvelabsApi.embed.v2.TasksListRequest,
3
    requestOptions?: Tasks.RequestOptions
4
): Promise<core.Page<TwelvelabsApi.MediaEmbeddingTask>>

Parameters:

Return value: Returns a Promise that resolves to a Page<MediaEmbeddingTask> object that allows you to iterate through the paginated task results.

The Page<T> class contains the following properties and methods:

The MediaEmbeddingTask interface contains the following properties:

API Reference: List async embedding tasks

Create an async embedding task

Description: This method creates embeddings for audio and video content asynchronously.

Function signature and example:

1
create(
2
    request: TwelvelabsApi.embed.v2.CreateAsyncEmbeddingRequest,
3
    requestOptions?: Tasks.RequestOptions
4
): core.HttpResponsePromise<TwelvelabsApi.embed.v2.TasksCreateResponse>

Parameters:

AudioInputRequest

The AudioInputRequest interface specifies configuration for processing audio content. Required when inputType is audio.

VideoInputRequest

The VideoInputRequest interface specifies configuration for processing video content. Required when inputType is video.

MediaSource

The MediaSource interface specifies the source of the media file. Provide exactly one of the following:

AudioSegmentation

The AudioSegmentation interface specifies how the platform divides the audio into segments using fixed-length intervals.

AudioSegmentationFixed

The AudioSegmentationFixed interface configures fixed-length segmentation for audio.

VideoSegmentation

The VideoSegmentation type specifies how the platform divides the video into segments. Use one of the following:

Fixed segmentation: Divides the video into equal-length segments:

Dynamic segmentation: Divides the video into adaptive segments based on scene changes:

VideoSegmentationFixedFixed

The VideoSegmentationFixedFixed interface configures fixed-length segmentation for video.

VideoSegmentationDynamicDynamic

The VideoSegmentationDynamicDynamic interface configures dynamic segmentation for video based on scene changes.

Return value: Returns a Promise that resolves to a TasksCreateResponse object containing the task details.

The TasksCreateResponse interface contains the following properties:

API Reference: Create an async embedding task

Retrieve task status and results

Description: This method retrieves the status and the results of an async embedding task.

Task statuses:

• processing: The platform is creating the embeddings.
• ready: Processing is complete. Embeddings are available in the response.
• failed: The task failed. Embeddings were not created.

Invoke this method repeatedly until the status field is ready. When status is ready, use the embeddings from the response.

Function signature and example:

1
retrieve(
2
    taskId: string,
3
    requestOptions?: Tasks.RequestOptions
4
): core.HttpResponsePromise<TwelvelabsApi.EmbeddingTaskResponse>

Parameters:

Return value: Returns a Promise that resolves to an EmbeddingTaskResponse object containing the task status and results.

The EmbeddingTaskResponse interface contains the following properties:

For details about the EmbeddingData class, see the Create an async embedding task section.

API Reference: Retrieve embedding task

API Reference: Retrieve task status and results