v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Extract transcription from voice audio

Extract a text transcription from a voice audio sample.

post/v2/tts/voices/extract-transcription

Request body

projectIdstring uuid required
audioUrlstring uri required
languagestring

Optional language hint for transcription.

Example request

{
  "projectId": "ae6d58c6-c6bd-4ae0-ad74-b8b39c29928b",
  "audioUrl": "https://cdn.tryhamsa.com/uploads/voice.wav",
  "language": "en"
}

Response

Transcription extracted successfully.

successboolean
messagestring
messageKeystring

Example response

{
  "success": true,
  "message": "Operation completed successfully",
  "messageKey": "OPERATION_SUCCESSFUL",
  "data": {
    "transcription": "Hello, this is a transcription of your audio."
  }
}