GET /speech/transcriptions/{transcriptionId}
Transcription endpoint enable us to retrieve a previous speech recognition result or inform us on a long running speech recognition status. To access a speech recognition result transcriptionId should be provided.
Path parameters
-
transcriptionId string(uuid) Required
Id of the transcribed audio. It is a UUID string provided in the speech recognition result.
Responses
-
• 200
OK. Transcription Retrieved.
-
• 400
This response means that server could not understand the request due to invalid syntax.
-
• 401
Authentication is needed to get requested response. This is similar to 403, but in this case, authentication is possible.
-
• 403
Client does not have access rights to the content so server is rejecting to give proper response.
-
• 404
Server can not find requested resource.
-
• 405
The request method is known by the server but has been disabled and cannot be used.
-
• 429
The user has sent too many requests in a given amount of time ("rate limiting").
-
• 500
The server has encountered a situation it doesn't know how to handle.
-
• 501
The request method is not supported by the server and cannot be handled.
curl \
-X GET https://api.amerandish.com/v1/speech/transcriptions/{transcriptionId} \
-H "Authorization: Bearer $ACCESS_TOKEN"
{
"transcriptionId": "string",
"duration": 42.0,
"inferenceTime": 42.0,
"status": "queued",
"results": [
{
"transcript": "string",
"confidence": 42.0,
"words": [
{
"startTime": 42.0,
"endTime": 42.0,
"word": "string",
"confidence": 42.0
}
]
}
]
}
{
"code": 400,
"message": "Bad Request. Invalid JSON object."
}
{
"code": 401,
"message": "Unautherized. Invalid Authorization Token."
}
{
"code": 403,
"message": "Forbidden. Do not have access right to resource."
}
{
"code": 404,
"message": "Not Found. Requested id not found."
}
{
"code": 405,
"message": "Method Not Allowed."
}
{
"code": 429,
"message": "Too Many Requests. Your request is blocked due to exceeding rate limiting."
}
{
"code": 500,
"message": "Internal Server Error. Please retry later."
}
{
"code": 501,
"message": "Not Implemented. This functionality is not implemented yet."
}