The EmbedClient.V2Client.TasksClient class 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 class:

• 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
def list(
2
    self,
3
    *,
4
    started_at: typing.Optional[str] = None,
5
    ended_at: typing.Optional[str] = None,
6
    status: typing.Optional[str] = None,
7
    page: typing.Optional[int] = None,
8
    page_limit: typing.Optional[int] = None,
9
    request_options: typing.Optional[RequestOptions] = None,
10
) -> SyncPager[MediaEmbeddingTask]

Parameters:

Return value: Returns a SyncPager[MediaEmbeddingTask] object that allows you to iterate through the paginated task results.

The SyncPager[T] class contains the following properties and methods:

The MediaEmbeddingTask class 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
def create(
2
    self,
3
    *,
4
    input_type: CreateAsyncEmbeddingRequestInputType,
5
    model_name: str,
6
    audio: typing.Optional[AudioInputRequest] = OMIT,
7
    video: typing.Optional[VideoInputRequest] = OMIT,
8
    request_options: typing.Optional[RequestOptions] = None,
9
) -> TasksCreateResponse

Parameters:

AudioInputRequest

The AudioInputRequest class specifies configuration for processing audio content. Required when input_type is audio.

VideoInputRequest

The VideoInputRequest class specifies configuration for processing video content. Required when input_type is video.

MediaSource

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

AudioSegmentation

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

AudioSegmentationFixed

The AudioSegmentationFixed class 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 class configures fixed-length segmentation for video.

VideoSegmentationDynamicDynamic

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

Return value: Returns a TasksCreateResponse object containing the task details.

The TasksCreateResponse class 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
def retrieve(
2
    self,
3
    task_id: str,
4
    *,
5
    request_options: typing.Optional[RequestOptions] = None
6
) -> EmbeddingTaskResponse

Parameters:

Return value: Returns an EmbeddingTaskResponse object containing the task status and results.

The EmbeddingTaskResponse class contains the following properties:

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

API Reference: Retrieve task status and results