Voice Activity Detection: get result

GET /api/technology/voice-activity-detection/:task_id

Retrieve the result of a Voice Activity Detection task.

Request

Path Parameters

task_id uuidrequired

ID of the task to get result of.

Header Parameters

x-correlation-id X-Correlation-Id

Correlation ID is a special type of request ID which is unique over a series of requests and responses, identifying a transaction in a distributed system. Correlation ID will be generated if not provided.

x-request-id X-Request-Id

In distributed system architecture (microservices architecture) it is a unique ID of request and response combination throughout all components of a distributed system. Request ID will be generated if not provided.

Responses

Result response of Voice Activity Detection task.

The response body contains task info in the task field. Depending on the task processing outcome, either result or error field is populated.

application/json

Schema
Example (from schema)
task done
task rejected
task failed

Schema

task

object

required

task_id uuidrequired

state TaskInfoState (string)required

Possible values: [pending, running, rejected, failed, done]

result

object

anyOf

VoiceActivityDetectionResult

Result of Voice Activity Detection task.

channels

object[]

required

Array [

channel_number Channel Number (integer)required

Channel number (0-base indexed).

speech_length Speech Length (number)required

Amount of speech in the channel detected by Voice Activity Detection.

segments

object[]

required

The list of segments detected by Voice Activity Detection, each containing a segment type and the time boundaries of the segment.

Array [

segment_type Segment Type (string)required

Possible values: [voice]

Type of segment detected by Voice Activity Detection.

start_time Start Time (number)required

Start time of the segment.

end_time End Time (number)required

End time of the segment.

]

error

object

anyOf

TaskErrorResult

Result schema for a failed or rejected task.

type TaskErrorType (string)required

Possible values: [internal, task.validation-error]

Machine-readable error type.

message Message (string)required

Human-readable summary of the error.

detail

object[]

Optional higher level of detail. It is intended for better understanding of the error or advanced error handling.

Array [

location

object[]

required

Location of the error.

Array [

anyOf

MOD1
MOD2

integer

]

message Message (string)required

Human-readable summary of the error.

type Type (string)required

Machine-readable error type.

context

object

Optional key-value object with additional context

property name*

object

anyOf

MOD1
MOD2
MOD3
MOD4
MOD5

string

]

{
  "task": {
    "task_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "state": "pending"
  },
  "result": {},
  "error": {}
}

Voice Activity Detection task done

{
  "task": {
    "task_id": "123e4567-e89b-12d3-a456-426614174000",
    "state": "done"
  },
  "result": {
    "channels": [
      {
        "channel_number": 0,
        "speech_length": 61.76,
        "segments": [
          {
            "segment_type": "voice",
            "start_time": 3.43,
            "end_time": 7.4
          },
          {
            "segment_type": "voice",
            "start_time": 20.21,
            "end_time": 24.98
          },
          {
            "segment_type": "voice",
            "start_time": 25.63,
            "end_time": 34.29
          },
          {
            "segment_type": "voice",
            "start_time": 36.87,
            "end_time": 41.87
          },
          {
            "segment_type": "voice",
            "start_time": 53.49,
            "end_time": 60.43
          },
          {
            "segment_type": "voice",
            "start_time": 61.43,
            "end_time": 74.32
          },
          {
            "segment_type": "voice",
            "start_time": 80.07,
            "end_time": 86.43
          },
          {
            "segment_type": "voice",
            "start_time": 97.32,
            "end_time": 103.19
          },
          {
            "segment_type": "voice",
            "start_time": 104.43,
            "end_time": 111.73
          }
        ]
      },
      {
        "channel_number": 1,
        "speech_length": 21.82,
        "segments": [
          {
            "segment_type": "voice",
            "start_time": 8.93,
            "end_time": 12.43
          },
          {
            "segment_type": "voice",
            "start_time": 14.89,
            "end_time": 19.18
          },
          {
            "segment_type": "voice",
            "start_time": 24.78,
            "end_time": 27.02
          },
          {
            "segment_type": "voice",
            "start_time": 43.69,
            "end_time": 48.81
          },
          {
            "segment_type": "voice",
            "start_time": 87.43,
            "end_time": 90.18
          },
          {
            "segment_type": "voice",
            "start_time": 92.4,
            "end_time": 96.32
          }
        ]
      }
    ]
  }
}

Voice Activity Detection task rejected

{
  "task": {
    "task_id": "123e4567-e89b-12d3-a456-426614174000",
    "state": "rejected"
  },
  "error": {
    "type": "task.validation-error",
    "message": "Task validation error.",
    "detail": []
  }
}

Voice Activity Detection task failed

{
  "task": {
    "task_id": "123e4567-e89b-12d3-a456-426614174000",
    "state": "failed"
  },
  "error": {
    "type": "internal",
    "message": "Service error.",
    "detail": []
  }
}

Request payload data was invalid and could not be parsed.

application/json

Schema
Example (from schema)
request.invalid

Schema

type RequestErrorType (string)required

Possible values: [internal, resource.not-found, method.invalid, request.forbidden, request.invalid, request.validation-error, request.rate-limit-exceeded, request.size-limit-exceeded, storage.capacity-exceeded]

Machine-readable error type.

message Message (string)required

Human-readable summary of the error.

detail

object[]

Optional higher level of detail. It is intended for better understanding of the error or advanced error handling.

Array [

location

object[]

required

Location of the error.

Array [

anyOf

MOD1
MOD2

integer

]

message Message (string)required

Human-readable summary of the error.

type Type (string)required

Machine-readable error type.

context

object

Optional key-value object with additional context

property name*

object

anyOf

MOD1
MOD2
MOD3
MOD4
MOD5

string

]

{
  "type": "internal",
  "message": "string",
  "detail": [
    {
      "location": [
        0,
        "string"
      ],
      "message": "string",
      "type": "string",
      "context": {}
    }
  ]
}

Invalid request.

{
  "type": "request.invalid",
  "message": "Invalid request.",
  "detail": []
}

The requested task does not exist.

The provided task_id may be wrong or the task may have expired already.

application/json

Schema
Example (from schema)
not found

Schema

type RequestErrorType (string)required

Machine-readable error type.

message Message (string)required

Human-readable summary of the error.

detail

object[]

Optional higher level of detail. It is intended for better understanding of the error or advanced error handling.

Array [

location

object[]

required

Location of the error.

Array [

anyOf

MOD1
MOD2

integer

]

message Message (string)required

Human-readable summary of the error.

type Type (string)required

Machine-readable error type.

context

object

Optional key-value object with additional context

property name*

object

anyOf

MOD1
MOD2
MOD3
MOD4
MOD5

string

]

{
  "type": "internal",
  "message": "string",
  "detail": [
    {
      "location": [
        0,
        "string"
      ],
      "message": "string",
      "type": "string",
      "context": {}
    }
  ]
}

Task not found.

{
  "type": "resource.not-found",
  "message": "Resource not found.",
  "detail": [
    {
      "location": [
        "root"
      ],
      "message": "Task not found.",
      "type": "task.not-found",
      "context": {
        "task_id": "123e4567-e89b-12d3-a456-426614174000"
      }
    }
  ]
}

Error during validation of request payload data occurred.

application/json

Schema
Example (from schema)
request validation error

Schema

type RequestErrorType (string)required

Machine-readable error type.

message Message (string)required

Human-readable summary of the error.

detail

object[]

Optional higher level of detail. It is intended for better understanding of the error or advanced error handling.

Array [

location

object[]

required

Location of the error.

Array [

anyOf

MOD1
MOD2

integer

]

message Message (string)required

Human-readable summary of the error.

type Type (string)required

Machine-readable error type.

context

object

Optional key-value object with additional context

property name*

object

anyOf

MOD1
MOD2
MOD3
MOD4
MOD5

string

]

{
  "type": "internal",
  "message": "string",
  "detail": [
    {
      "location": [
        0,
        "string"
      ],
      "message": "string",
      "type": "string",
      "context": {}
    }
  ]
}

Request validation error.

{
  "type": "request.validation-error",
  "message": "Request validation error.",
  "detail": []
}

Request rate limit exceeded.

The request may be retried after a while. The following response headers may be checked for details: retry-after, x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.

Response Headers

retry-after
number
Header indicates how long the user agent should wait before making a follow-up request.
x-ratelimit-limit
number
Size of the current rate limiting window.
x-ratelimit-remaining
number
Remaining number of requests in the current rate limiting window.
x-ratelimit-reset
number
Time at which the current rate limiting window resets (in UTC epoch).

application/json

Schema
Example (from schema)
request.rate-limit-exceeded

Schema

type RequestErrorType (string)required

Machine-readable error type.

message Message (string)required

Human-readable summary of the error.

detail

object[]

Optional higher level of detail. It is intended for better understanding of the error or advanced error handling.

Array [

location

object[]

required

Location of the error.

Array [

anyOf

MOD1
MOD2

integer

]

message Message (string)required

Human-readable summary of the error.

type Type (string)required

Machine-readable error type.

context

object

Optional key-value object with additional context

property name*

object

anyOf

MOD1
MOD2
MOD3
MOD4
MOD5

string

]

{
  "type": "internal",
  "message": "string",
  "detail": [
    {
      "location": [
        0,
        "string"
      ],
      "message": "string",
      "type": "string",
      "context": {}
    }
  ]
}

Rate limit exceeded.

{
  "type": "request.rate-limit-exceeded",
  "message": "Rate limit exceeded: 1 per 5 second.",
  "detail": []
}

Voice Activity Detection: get result

/api/technology/voice-activity-detection/:task_id

Request​

Path Parameters

Header Parameters

Responses​

Request

Responses