Convert anything to OGG

The API for converting any file to OGG.

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: 6 8 12 16 24 32 44 48 56 64 80 96 112 128 160 192 224 256 320 500	Audio bitrate in kbps.
audio_codec Type: string Enum: speex vorbis opus copy	Sets the audio codec
audio_vbr Type: integer Enum: 64 80 96 112 128 160 192 224 256 320 500	If selected, a variable bitrate conversion is processed. The values are the average bitrate in kbit/s per stereo channel. Only working for vorbis.
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 96000	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
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.mp3"
    }],
    "conversion": [{
        "category": "audio",
        "target": "ogg",
        "options": {
            <conversion options here>
        }
    }]
}