Skip to main content
GET
/
streaming
/
ai
/
tasks
Python
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
page = client.streaming.ai_tasks.list()
page = page.results[0]
print(page.task_id)
{
  "count": 0,
  "next": "<string>",
  "previous": "<string>",
  "results": [
    {
      "task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "PENDING",
      "progress": 123,
      "task_name": "content-moderation",
      "task_data": {
        "url": "https://demo-files.gvideo.io/apidocs/spritefright-blender-cut30sec.mp4",
        "task_name": "transcription",
        "audio_language": "ger"
      }
    }
  ]
}

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
​
search
string

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[]