Account7

Advanced analytics1

Advanced Rules9

AI5

Aliases9

Analytics12

Analyze1

API Discovery17

API Tokens8

Apps8

Bare Metal14

BGP announces2

Binaries4

Broadcasts6

CA certificates5

CDN activity logs2

CDN resources6

CDN service5

CDN Statistics9

Container as a Service19

Cost Reports6

Custom Page Sets7

Custom Rules10

DDoS Protection9

Directories5

DNS Clients1

DNS Locations4

DNSSEC4

Domains12

Edge Storage8

Event Logs2

Everywhere Inference28

Everywhere Inference Apps8

FastEdge Clients1

FastEdge Secrets6

FastEdge Templates5

File Shares17

Filter Templates5

Firewall Rules11

Floating IPs16

Function as a Service19

GPU Bare Metal46

GPU Virtual20

Images15

Instances44

IP addresses list2

IP Ranges1

IP Reputation3

IP Spotlight15

Let's Encrypt certificates6

Load Balancers57

Log viewer2

Logging10

Logs uploader24

Lookup1

Managed Kubernetes25

Managed PostgreSQL13

Metrics1

Network Organizations1

NetworkMappings7

Networks23

Notifications6

Origin shielding3

Origins6

Overlays6

Pickers2

Placement Groups4

Players6

Playlists6

Policies6

Policy Overrides6

Ports3

Pre-billing2

Presets8

Pricing1

Profiles10

Projects5

Protected Networks11

Protection Profiles7

Protection Templates3

Purge history1

QualitySets2

Quotas10

Regions2

Registry17

Reservations1

Reserved IPs11

Restreams5

Routers9

RRsets6

Rule templates6

Rules6

S3-Compatible Storage14

SecondaryZones13

Secrets5

Security Groups19

Security Insights14

Security Templates1

SFTP Storage5

Snapshot Schedules14

Snapshots7

SSH Keys14

SSHKeys9

SSL certificates6

Stats3

Storage24

Storage Locations3

Storage Statistics2

Streaming Statistics24

Streams11

Subtitles5

Tags1

Tasks6

Tools2

User Actions10

User Role Assignments6

Users8

Videos8

Volumes19

WAAP Service2

Zones10

Get AI task result

Changed on Sep 4, 2026

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: Not Safe For Work (NSFW) content detection
CM: Soft nudity detection
CM: Hard nudity 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:

RECEIVED – the task is accepted by the system
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/ai/tasks/{task_id}

Request

Base URL
https://api.gcore.com
URL
https://api.gcore.com/streaming/ai/tasks/{task_id}
Auth
HTTP apikey

Path parameters

task_idstring 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

Result of AI task execution

task_idstring uuid required

ID of the AI task

Status of processing the AI task. See GET /ai/tasks/{task_id} method for description.

progressinteger required

Percentage of task completed. A value greater than 0 means that it has been taken into operation and is being processed.

Example response

{
  "task_id": "aafe70c6-0000-0000-0000-327b65f7670f",
  "task_data": {
    "url": "https://demo-public.gvideo.io/videos/2675_TVKIqpTO7tEFoFg/qid5774v1_h264_450_360.mp4",
    "category": "sport",
    "client_id": 2675,
    "task_name": "content-moderation"
  },
  "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": {
    "sport_detected": true,
    "detection_results": [
      "shooting goal (soccer)",
      "playing cricket"
    ],
    "frames": [
      {
        "label": "shooting goal (soccer)",
        "frame_number": 68,
        "confidence": 1
      },
      {
        "label": "playing cricket",
        "frame_number": 728,
        "confidence": 0.99
      }
    ]
  }
}

Changes

Sep 4, 2026796429501557 Revision changes
- breaking
  the //////// response's property type changed from no type to object for status
- breaking
  the //////// response's property type changed from no type to object for status
- breaking
  the //////// response's property type changed from no type to object for status
- breaking
  the //////// response's property type changed from no type to object for status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  added the new RECEIVED enum value to the //// response property for the response status
- info
  added subschema #2 to the response body allOf list for the response status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  removed from the //////// response property allOf list for the response status
- info
  removed from the //////// response property allOf list for the response status
- info
  removed from the //////// response property allOf list for the response status
- info
  removed from the //////// response property allOf list for the response status
- info
  the response property //// became required for the status
- info
  the response property //// became required for the status
- info
  the response property //// became required for the status
- info
  the response property //// became required for the status
- info
  added the required property //// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status

Operation history