Endpoint Overview

The Audio Upload Endpoint allows developers to upload audio files (specifically MP3) for processing. This can include audio from TV shows, movies, music, in-flight announcements, or any other audio files requiring subtitle generation or translation.


Endpoint

POST /v1/audio/process

Required Request Parameters

Form Data

ParameterTypeDescription
emailstringEmail address of the user submitting the request.
keystringAPI key associated with the user's account for authentication.
filefileThe audio file to be uploaded. Only .mp3 format is supported.

Response

Success Response

Status Code: 200 OK

{
  "message": "File uploaded successfully in 123.45 ms and processing started",
  "email": "[email protected]",  
  "upload_time_ms": 123.45  
}

Error Responses

Status CodeError Message
400Invalid or missing parameters, file format errors, or usage limits exceeded.
403Invalid or inactive API key.
500Internal server errors during processing.

Try It

Language
Credentials
Header
Click Try It! to start a request and see the response here!