GET /speech/languagemodels/{languageModelId}

Retrieving the status of a language model with specified languageModelId. A language model is ready to use when its status is trained.

Path parameters

languageModelId string Required

Id of the language model.

Responses

200

OK. Language Model Retrieved.

Show response attributes object

languageModelId

string

This is the language model id of a customized trained language model. You can train your own language models and then use them to recognize speech. Refer to languagemodel/train for more info.

There are some pretrained language models which you can use.

Model	Description
general	Best for audio content that is not one of the specific language models. This is the default language model and if you are not sure which one to use, simply use 'general'.
numbers	Best for audio content that contains only spoken numbers. For examble this language model can be used for speech enabled number input fileds.
yesno	Best for audio content that contains yes or no. For examble this language model can be used to receive confirmation from user.
country	Best for audio content that contains only spoken country. For examble this language model can be used for speech enabled input fileds.
city	Best for audio content that contains only spoken city. For examble this language model

can be used for speech enabled input fileds. career | Best for audio content that contains only spoken career names. For examble this language model can be used for speech enabled input fileds.

name string

The name of the custom language model.
status string

Status of the language model training process. After a language model training finishes it can be used for speech recognition using its languageModelId.

Values are queued, training, or trained. Default value is queued.

400

This response means that server could not understand the request due to invalid syntax.
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  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.
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  Message explaining the issue.
- title string
  
  Error message title.
- type string
  
  Error type.
403

Client does not have access rights to the content so server is rejecting to give proper response.
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  Message explaining the issue.
- title string
  
  Error message title.
- type string
  
  Error type.
404

Server can not find requested resource.
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  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.
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  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").
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  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.
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  Message explaining the issue.
- title string
  
  Error message title.
- type string
  
  Error type.
501

The request method is not supported by the server and cannot be handled.
Hide response attributes Show response attributes object
- status string Required
  
  HTTP response status code.
- detail string Required
  
  Message explaining the issue.
- title string
  
  Error message title.
- type string
  
  Error type.

GET /speech/languagemodels/{languageModelId}

curl \
 -X GET https://api.amerandish.com/v1/speech/languagemodels/{languageModelId} \
 -H "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "languageModelId": "string",
  "name": "string",
  "status": "queued"
}

Response examples (200)

{
  "languageModelId": "string",
  "name": "string",
  "status": "queued"
}

Response examples (400)

{
  "code": 400,
  "message": "Bad Request. Invalid JSON object."
}

Response examples (400)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}

Response examples (401)

{
  "code": 401,
  "message": "Unautherized. Invalid Authorization Token."
}

Response examples (401)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}

Response examples (403)

{
  "code": 403,
  "message": "Forbidden. Do not have access right to resource."
}

Response examples (403)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}

Response examples (404)

{
  "code": 404,
  "message": "Not Found. Requested id not found."
}

Response examples (404)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}

Response examples (405)

{
  "code": 405,
  "message": "Method Not Allowed."
}

Response examples (405)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}

Response examples (429)

{
  "code": 429,
  "message": "Too Many Requests. Your request is blocked due to exceeding rate limiting."
}

Response examples (429)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}

Response examples (500)

{
  "code": 500,
  "message": "Internal Server Error. Please retry later."
}

Response examples (500)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}

Response examples (501)

{
  "code": 501,
  "message": "Not Implemented. This functionality is not implemented yet."
}

Response examples (501)

{
  "status": "string",
  "detail": "string",
  "title": "string",
  "type": "string"
}