Your email address belongs to a school and you are eligible for a free educational premium account.
Learn more

Convert anything to MP3


The API for converting any file to MP3.

Here you can see all available conversion options which you can use within the "options" section of conversions (see the example JSON below the table).

Here you can see all available conversion options which you can use within the "options" section of conversions (see the example JSON on the right).

Option Name Description
allow_multiple_outputs
Type: boolean
Default: False
If the conversion produces more than one output file, by default all of them are compressed in just one file. Set this option to true if you want a download link for each file.
allow_multiple_outputs_threshold
Type: integer
Minimum: 2
Maximum: 400
Sets the threshold for the number of output files during conversion. This option is considered only when `allow_multiple_outputs` is set to true. If the generated output files exceed this threshold, they are compressed into one file. Conversely, if the threshold is not met, each output file remains uncompressed.
audio_bitrate
Type: integer
Enum: 8 16 24 32 40 48 56 64 96 112 128 160 192 224 256 320
Audio bitrate in kbps.
audio_vbr
Type: integer
Enum: 65 85 100 115 130 165 175 190 225 245
If selected, a variable bitrate conversion is processed. The values are the average bitrate in kbit/s.
channels
Type: string
Enum: stereo mono
Audio channels.
download_password
Type: string
Pattern: ^[ -~]{0,1000}$
Example: secret_password
A password to protect the download. To download the file send the password in the x-oc-download-password header or set a cookie named x-oc-download-password. The value contains a comma separated list of passwords.
end
Type: string
Pattern: ^\d\d:\d\d:\d\d$
Sets the end point of the part of the video you want to keep. The format is HH:MM:SS. HH = hour, MM = minutes, SS = seconds. Example 00:05:35
frequency
Type: integer
Enum: 8000 11025 16000 22050 24000 32000 44100 48000
Audio frequency in Hz.
language_tts
Type: string
Enum: ar-SA bg-BG ca-ES cs-CZ da-DK de-CH de-DE el-GR en-AU en-CA en-GB en-IE en-IN en-US es-ES es-MX fi-FI fr-CA fr-CH fr-FR hi-IN hr-HR hu-HU id-ID it-IT ja-JP nb-NO nl-BE nl-NL pl-PL pt-BR pt-PT ro-RO ru-RU sv-SE ta-IN tr-TR vi-VN zh-CN zh-HK
Language of the speaker
normalize
Type: boolean
Default: False
Normalize the audio volume.
normalize_loudness_range_target_ebu
Type: number
Minimum: True
Maximum: 50
EBU Loudness Range Target in LUFS (default 7.0). Ignored if normalize_type is not ebu.
normalize_target_level
Type: integer
Minimum: -99
Maximum: False
Normalization target level in dB/LUFS (default -23). Ignored when normalize_type=ebu.
normalize_target_level_ebu
Type: number
Minimum: -70
Maximum: -5
Integrated Loudness Target in LUFS. Ignored if normalize_type is not ebu.
normalize_true_peak_ebu
Type: number
Minimum: -9
Maximum: False
EBU Maximum True Peak in dBTP (default -2.0). Ignored if normalize_type is not ebu.
normalize_type
Type: string
Enum: ebu rms peak
Normalization type, brings the signal to the specified RMS or peak level, or applies EBU R128 for broadcasting.
output_filename
Type: string
Pattern: ^[\w\W]{0,255}$
Example: my_base_filename_without_extension
The desired file name of the converted file WITHOUT the file extension.
preset
Type: string
Pattern: ^[\w\W]{1,255}$
Predefined options
remove_coverart
Type: boolean
Default: False
Remove the cover art image
start
Type: string
Pattern: ^\d\d:\d\d:\d\d$
Sets the start point of the part of the video you want to keep. The format is HH:MM:SS. HH = hour, MM = minutes, SS = seconds. Example 00:02:23

Output Example

POST /v2/jobs HTTP/1.1
Host: https://api.api2convert.com
X-Oc-Api-Key: <your API key here>
Content-Type: application/json
{
    "input": [{
        "type": "remote",
        "source": "https://example-files.online-convert.com/audio/mp3/example.wav"
    }],
    "conversion": [{
        "category": "audio",
        "target": "mp3",
        "options": {
            <conversion options here>
        }
    }]
}