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 |
|
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. |
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. |
volume
Type: string Pattern: (^([0-4]\.?[0-9]{1,2}?$)|^5(\.0)?$)|(^-[1-9]?[0-9]dB$)|(^[+]?[1-2]?[0-9]dB$) |
Sets the new volume level. For example, a value of 0.5 will reduce the volume by half, while a value of 2 will double it. It is possible to use decibel values too. E.g. -10dB or +5dB. |
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/raster%20image/png/example_small.png"
}],
"conversion": [{
"category": "operation",
"target": "audio-volume",
"options": {
<conversion options here>
}
}]
}