WAwavix
Speech Analytics

Upload a file

Changed on

Uploads an audio file for transcription. Transcription is asynchronous; Wavix sends a POST callback to callback_url when it completes, including the request_id returned by this request.

Callback body:

   {
        "request_id": "e865ea07-25af-4fdd-876e-04b0d41d5ebd",
        "status": "completed",
        "error": null
   }
  • request_id: ID of the transcription request.
  • status: One of completed (transcription succeeded) or failed (transcription encountered an error).
  • error: Error description, or null when the transcription succeeded.
post/v1/speech-analytics

Request

  • Base URL
    https://api.wavix.com
  • URL
    https://api.wavix.com/v1/speech-analytics
  • Auth
    HTTP bearer

Request body multipart/form-data

filestring binary required

Audio file to transcribe. Maximum size is 25 MB. Supported formats are WAV, MP3, and MP4 stereo.

callback_urlstring required

URL that receives the POST callback when transcription completes.

insightsboolean

When true, generates conversation insights alongside the transcript.

Example request

{
  "callback_url": "https://you-site.com/webhook",
  "insights": true
}

Response

Returns the transcription request_id for the uploaded file.

filestring required

Uploaded file name.

request_idstring required

Transcription request ID.

successboolean required

Indicates whether the request was successful.

Example response

{
  "file": "file.mp3",
  "request_id": "e865ea07-25af-4fdd-876e-04b0d41d5ebd",
  "success": true
}

Changes

  • 6a89c962481cRevision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 33be77905120Revision changes
    • info

      the endpoint scheme security bearerAuth was added to the API