Skip to main content
POST
Python

Authorizations

Authorization
string
header
required

Body

multipart/form-data
audio_url
string
required

Input audio URL (supported format: YouTube URL).

Example:

"https://example.com/audio.mp3"

audio_file
file

Audio file to upload and process directly.

language
string

Language spoken in the audio (empty for auto-detection).

Example:

"en"

translate
boolean

Whether to translate the transcription to English.

Example:

false

transcription_format
enum<string>

Format of the transcribed output.

Available options:
plain_text,
formatted_text,
srt,
vtt
Example:

"plain_text"

translation_format
enum<string>

Format of the translated output (currently unused).

Available options:
plain_text,
formatted_text,
srt,
vtt
Example:

"plain_text"

word_timestamps
boolean

Whether to include word-level timestamps.

Example:

false

webhook_url
string

Callback URL for async processing results.

Example:

"http://your-webhook-url.com/callback"

Response

Successfully initiated transcription

success
boolean
task_id
string
conversion_id
string
eta
integer
credit_estimate
number<float>
message
string