Skip to main content
POST
/
v2
/
tts
/
voices
/
extract-transcription
Extract transcription from voice audio
curl --request POST \
  --url https://api.tryhamsa.com/v2/tts/voices/extract-transcription \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "ae6d58c6-c6bd-4ae0-ad74-b8b39c29928b",
  "audioUrl": "https://cdn.tryhamsa.com/uploads/voice.wav",
  "language": "en"
}
'
{
  "success": true,
  "message": "Operation completed successfully",
  "messageKey": "OPERATION_SUCCESSFUL",
  "data": {
    "transcription": "Hello, this is a transcription of your audio."
  }
}

Authorizations

​
Authorization
string
header
required

Pass the API key in the Authorization header, You need to put Token keyword before the API key. e.g. 'Authorization: Token '

Body

application/json
​
projectId
string<uuid>
required
Example:

"ae6d58c6-c6bd-4ae0-ad74-b8b39c29928b"

​
audioUrl
string<uri>
required
Example:

"https://cdn.tryhamsa.com/uploads/voice.wav"

​
language
string

Optional language hint for transcription.

Example:

"en"

Response

Transcription extracted successfully.

​
success
boolean
Example:

true

​
message
string
Example:

"Operation completed successfully"

​
messageKey
string
Example:

"OPERATION_SUCCESSFUL"

​
data
object