Get AI task result

This is the single method to check the execution status of an AI task, and obtain the result of any type of AI task. Based on the results of processing, the “result” field will contain an answer corresponding to the type of the initially created task:

ASR: Transcribe video
ASR: Translate subtitles
CM: Sports detection
CM: Weapon detection
CM: Not Safe For Work (NSFW) content detection
CM: Soft nudity detection
CM: Hard nudity detection
CM: Child Sexual Abuse Material (CSAM) detection
CM: Objects recognition (soon)
etc… (see other methods from /ai/ domain)

A queue is used to process videos. The waiting time depends on the total number of requests in the system, so sometimes you will have to wait. Statuses:

PENDING – the task is received and it is pending for available resources
STARTED – processing has started
SUCCESS – processing has completed successfully
FAILURE – processing failed
REVOKED – processing was cancelled by the user (or the system)
RETRY – the task execution failed due to internal reasons, the task is queued for re-execution (up to 3 times) Each task is processed in sub-stages, for example, original language is first determined in a video, and then transcription is performed. In such cases, the video processing status may change from “STARTED” to “PENDING”, and back. This is due to waiting for resources for a specific processing sub-stage. In this case, the overall percentage “progress” of video processing will reflect the full picture.

The result data is stored for 1 month, after which it is deleted.

For billing conditions see the corresponding methods in /ai/ domain. The task is billed only after successful completion of the task and transition to “SUCCESS” status.

GET

streaming

tasks

{task_id}

curl --request GET \
  --url https://api.gcore.com/streaming/ai/tasks/{task_id} \
  --header 'APIKey: <api-key>'

{
  "task_id": "aafe70c6-0000-0000-0000-327b65f7670f",
  "task_data": {},
  "progress": 100,
  "status": "SUCCESS",
  "processing_time": {
    "started_at": "2024-07-13T12:30:00.000Z",
    "completed_at": "2024-07-13T12:31:02.900Z",
    "total_time_sec": 62.901
  },
  "result": {}
}

Authorizations

APIKey

string

header

required

API key for authentication.

Path Parameters

task_id

string

required

ID of the task to get status of execution or result. This value is taken from the response of the initial AI task creation method.

Response

200

application/json

Result of AI task execution

The response is of type object.

Create AI CM:weapon task Cancel AI task

curl --request GET \
  --url https://api.gcore.com/streaming/ai/tasks/{task_id} \
  --header 'APIKey: <api-key>'

{
  "task_id": "aafe70c6-0000-0000-0000-327b65f7670f",
  "task_data": {},
  "progress": 100,
  "status": "SUCCESS",
  "processing_time": {
    "started_at": "2024-07-13T12:30:00.000Z",
    "completed_at": "2024-07-13T12:31:02.900Z",
    "total_time_sec": 62.901
  },
  "result": {}
}

Overview

IAM

CDN

Managed DNS

Cloud

Security

FastEdge

WAAP

Web Security

Video Streaming

Object Storage

Get AI task result

Authorizations

Path Parameters

Response