v1

latestOpenAPI 3.0.1MIT2026-07-26104203277.0 KB

Transcribe media to text

post/v1/jobs/transcribe

Request body

mediaUrlstring uri required

processingType'async'

webhookUrlstring uri

titlestring

model'Hamsa-General-V2.0' | 'Hamsa-Conversational-V1.0' required

language'ar' | 'en'

returnSrtFormatboolean

Example request

{
  "webhookAuth": {
    "authKey": "Token",
    "authSecret": "Secret"
  },
  "srtOptions": {
    "maxLinesPerSubtitle": 2,
    "singleSpeakerPerSubtitle": true,
    "maxCharsPerLine": 42,
    "maxMergeableGap": 0.3,
    "minDuration": 0.7,
    "maxDuration": 7,
    "minGap": 0.04
  }
}

Response

Successful response

successboolean

messagestring