GET
/
streaming
/
ai
/
tasks
Get list of AI tasks
curl --request GET \
  --url https://api.gcore.com/streaming/ai/tasks \
  --header 'Authorization: <api-key>'
{
  "count": 127,
  "next": "page=2",
  "previous": null,
  "results": [
    {
      "task_id": "aafe70c6-0000-0000-0000-327b65f7670f",
      "task_name": "content-moderation",
      "task_data": {},
      "progress": 100,
      "status": "SUCCESS"
    },
    {
      "task_id": "aafe70c6-0000-0000-0000-d3bcebebf37c",
      "task_name": "transcription",
      "task_data": {},
      "progress": 50,
      "status": "STARTED"
    }
  ]
}

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

task_id
string<uuid>

The task unique identifier to fiund

task_name
enum<string>

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

Available options:
transcription,
content-moderation
status
enum<string>

Task status

Available options:
FAILURE,
PENDING,
RECEIVED,
RETRY,
REVOKED,
STARTED,
SUCCESS
date_created
string

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

ordering
enum<string>

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.

Available options:
task_id,
status,
task_name,
started_at

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
page
integer
default:1

Page to view from task list, starting from 1

limit
integer
default:10

Number of results to return per page.

Response

List of AI tasks

count
integer
default:0

Total number of tasks

next
string

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

previous
string

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

results
object[]