# GET /speech/asrlive

**GET /speech/asrlive**

## Performs asynchronous live speech recognition using websocket
***
This resource establish a websocket with client and receives audio data using websocket. It will start transcribing the audio using state-of-the-art deep neural networks and returns the partial results on the websocket.
This endpoint is designed for transcription of stream audio data upto 15 minute. It will send back partial (status=partial) result everytime it transcribes an endpoint. After client sends the close signal, it will receive a ASRResponseBody with status=done.
Token should be passed in query string as jwt.
***
Using *config* object you can can specify audio configs such as *audioEncoding* and *sampleRateHertz*. We will support different languages so you can choose the *languageCode*. Using *asrModel* and *languageModel* in config you can use customized models.
Refer to *ASRLongRuning API* for long audio speech recognition.
Refer to *ASR API* for fast recognition for short audio files.



## Servers


## Authentication methods
- Api key auth


## Parameters




## Responses
### 403
Client does not have access rights to the content so server is rejecting to give proper response.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 200
OK.

#### Body:  (object)
- **transcriptionId** (string(uuid))
  A UUID string specifying a unique pair of audio and recognitionResult. It can be used to retrieve this recognitionResult using transcription endpoint. asrLongRunning recognitionResult will only be available using transcription endpoint and this transcriptionId.
- **duration** (number(double))
  File duration in seconds.
- **inferenceTime** (number(double))
  Total inference time in seconds.
- **status** (string)
  Status of the recognition process. *USE THE RECOGNITION RESULT ONLY WHEN STATUS IS DONE*.
- **results** (array[object])
  Sequential list of transcription results corresponding to sequential portions of audio. May contain one or more recognition hypotheses (up to the maximum specified in maxAlternatives). These alternatives are ordered in terms of accuracy, with the top (first) alternative being the most probable, as ranked by the recognizer.

### 400
This response means that server could not understand the request due to invalid syntax.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 401
Authentication is needed to get requested response. This is similar to 403, but in this case, authentication is possible.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 405
The request method is known by the server but has been disabled and cannot be used.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 415
The media format of the requested data is not supported by the server, so the server is rejecting the request.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 429
The user has sent too many requests in a given amount of time ("rate limiting").


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.

### 500
The server has encountered a situation it doesn't know how to handle.


#### Body:  (object)
- **status** (string)
  HTTP response status code.
- **detail** (string)
  Message explaining the issue.
- **title** (string)
  Error message title.
- **type** (string)
  Error type.


[Powered by Bump.sh](https://bump.sh)