Sign in

v32

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

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: 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:

  • 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}

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

ID of the AI task

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

Status of processing the AI task. See GET /ai/results method for description.

progressinteger

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

task_name'content-moderation' | 'transcription'

Type of AI task

Example response

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