The AnalyzeAsyncClient.TasksClient class provides methods to analyze videos asynchronously and generate text based on their content. Use these methods for videos longer than 1 hour.

When to use this class:

• Analyze videos longer than 1 hour
• Process videos up to 2 hours
• Avoid blocking your application during video processing

Do not use this class for:

• Videos under 1 hour for which you need immediate results or real-time streaming. Use the analyze method instead.

Analyzing videos asynchronously requires three steps:

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

Methods

List analysis tasks

Description: This method returns a list of the analysis tasks in your account. The platform returns your analysis 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
    page: typing.Optional[int] = None,
5
    page_limit: typing.Optional[int] = None,
6
    status: typing.Optional[AnalyzeTaskStatus] = None,
7
    request_options: typing.Optional[RequestOptions] = None,
8
) -> TasksListResponse:

Parameters:

Return value: Returns a TasksListResponse object.

The TasksListResponse class contains the following properties:

The PageInfo class contains the following properties:

For details about AnalyzeTaskResponse, see Retrieve task status and results.

API Reference: List async analysis tasks

Create an async analysis task

Description: This method asynchronously analyzes a video and generates text based on its content.

Function signature and example:

1
def create(
2
    self,
3
    *,
4
    video: VideoContext,
5
    prompt: str,
6
    temperature: typing.Optional[float] = OMIT,
7
    max_tokens: typing.Optional[int] = OMIT,
8
    response_format: typing.Optional[ResponseFormat] = OMIT,
9
    request_options: typing.Optional[RequestOptions] = None,
10
) -> CreateAnalyzeTaskResponse:

Parameters:

VideoContext

The VideoContext type specifies the source of the video. Provide exactly one of the following:

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

The CreateAnalyzeTaskResponse class contains the following properties:

API Reference: Create an async analysis task

Retrieve task status and results

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

Task statuses:

• queued: The task is waiting to be processed.
• pending: The task is queued and waiting to start.
• processing: The platform is analyzing the video.
• ready: Processing is complete. Results are available in the response.
• failed: The task failed. No results were generated.

Call this method repeatedly until status is ready or failed. When status is ready, use the results 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
) -> AnalyzeTaskResponse:

Parameters:

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

The AnalyzeTaskResponse class contains the following properties:

The AnalyzeTaskResult class contains the following properties:

The AnalyzeTaskResultUsage class contains the following properties:

The AnalyzeTaskError class contains the following properties:

API Reference: Retrieve analysis task status and results

Delete an analysis task

Description: This method deletes an analysis task. You can only delete tasks that are not currently being processed.

Function signature and example:

1
def delete(
2
    self,
3
    task_id: str,
4
    *,
5
    request_options: typing.Optional[RequestOptions] = None,
6
) -> None:

Parameters:

Return value: Returns None. If successful, the platform returns a 204 No Content response.

API Reference: Delete an analysis task