Language Identification: get result

GET /api/technology/language-identification/:task_id

Retrieve the result of a Language Identification 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 Language Identification 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

LanguageIdentificationResult

Result of Language Identification task.

channels

object[]

required

Array [

channel_number Channel Number (integer)required

Channel number (0-base indexed).

speech_length Speech Length (number)required

Length of speech in seconds used for identification.

scores

object[]

required

The list of Language Identification scores for individual languages or language groups. All probability values for languages and groups should sum to 1. The probabilities of individual languages within a language group should sum to the global group score. Due to conversion errors, the actual sums can differ from 1 or from the group score by a very small fraction.

Array [

anyOf

LanguageIdentificationGroupScore
LanguageIdentificationScore

The Language Identification score for a language group.

identifier Identifier (string)required

identifier_type Identifier Type (string)required

Possible values: [language, group]

Information whether the score belongs to a single language or a language group.

probability floatrequired

The probability of the media file containing the given language or the sum of probabilities for the elements of the language group. Probability values are rounded to 5 decimal places.

languages

object[]

required

The list of Language Identification scores for individual languages within the language group.

Array [

identifier Identifier (string)required

identifier_type Identifier Type (string)required

Possible values: [language, group]

Information whether the score belongs to a single language or a language group.

probability floatrequired

The probability of the media file containing the given language or the sum of probabilities for the elements of the language group. Probability values are rounded to 5 decimal places.

]

The Language Identification score for a language.

identifier Identifier (string)required

identifier_type Identifier Type (string)required

Possible values: [language, group]

Information whether the score belongs to a single language or a language group.

probability floatrequired

The probability of the media file containing the given language or the sum of probabilities for the elements of the language group. Probability values are rounded to 5 decimal places.

]

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": {}
}

Language Identification task done

{
  "task": {
    "task_id": "123e4567-e89b-12d3-a456-426614174000",
    "state": "done"
  },
  "result": {
    "channels": [
      {
        "channel_number": 0,
        "speech_length": 20,
        "scores": [
          {
            "identifier": "cs-CZ",
            "identifier_type": "language",
            "probability": 0.98
          },
          {
            "identifier": "english",
            "identifier_type": "group",
            "probability": 0.02,
            "languages": [
              {
                "identifier": "en-US",
                "identifier_type": "language",
                "probability": 0.015
              },
              {
                "identifier": "en-GB",
                "identifier_type": "language",
                "probability": 0.005
              }
            ]
          }
        ]
      }
    ]
  }
}

Language Identification task rejected

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

Language Identification 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": []
}

Language Identification: get result

/api/technology/language-identification/:task_id

Request​

Path Parameters

Header Parameters

Responses​

Request

Responses