v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
AI

Get list of AI tasks

Returns a list of previously created and processed AI tasks.

The list contains brief information about the task and its execution status. Data is displayed page by page.

get/streaming/ai/tasks

Query parameters

task_idstring uuid

The task unique identifier to fiund

task_name'transcription' | 'content-moderation'

Type of the AI task. Reflects the original API method that was used to create the AI task.

status'FAILURE' | 'PENDING' | 'RECEIVED' | 'RETRY' | 'REVOKED' | 'STARTED' | 'SUCCESS'

Task status

date_createdstring

Time when task was created. Datetime in ISO 8601 format.

ordering'task_id' | 'status' | 'task_name' | 'started_at'

Which field to use when ordering the results: task_id, status, and task_name. Sorting is done in ascending (ASC) order.

If parameter is omitted then "started_at DESC" is used for ordering by default.

searchstring

This is an field for combined text search in the following fields: task_id, task_name, status, and task_data.

Both full and partial searches are possible inside specified above fields. For example, you can filter tasks of a certain category, or tasks by a specific original file.

Example:

  • To filter tasks of Content Moderation NSFW method: GET /streaming/ai/tasks?search=nsfw
  • To filter tasks of processing video from a specific origin: GET /streaming/ai/tasks?search=s3.eu-west-1.amazonaws.com
pageinteger

Page to view from task list, starting from 1

limitinteger

Number of results to return per page.

Response

List of AI tasks

countinteger

Total number of tasks

nextstring

Pointer to next page, is part of query string of the request

previousstring

Pointer to the previous page, is part of query string of the request

Example response

{
  "results": [
    {
      "task_data": {
        "url": "https://demo-files.gvideo.io/apidocs/spritefright-blender-cut30sec.mp4",
        "task_name": "transcription",
        "audio_language": "ger"
      }
    }
  ]
}