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. |
aspect_ratio
Type: string Pattern: ^\d{1,6}:\d{1,6}$ |
Specify the aspect ratio of the video e.g. 16:9. |
audio_codec
Type: string Enum: amr-nb aac copy |
Sets the audio codec |
audio_frequency
Type: integer Enum: 8000 11025 16000 22050 24000 32000 44100 48000 96000 |
Audio frequency in Hz. |
channel
Type: string Enum: stereo mono |
Audio channels. |
codec
Type: string Enum: h.263 h.264 mpeg4 copy |
Sets the video codec |
crf
Type: integer Minimum: False Maximum: 51 |
The Constant Rate Factor (CRF) allows the encoder to attempt to achieve a certain output quality for the whole file when output file size is of less importance. Lower values result in better quality at the expense of a higher file size. This option will be ignored if video_bitrate is set. |
default_still_frame_duration
Type: number Minimum: 0.02867 Maximum: 1800 |
Defines the duration in seconds of a still frame. E.g. when converting from images or documents. |
deinterlace
Type: boolean Default: False |
Deinterlace the video |
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 |
format
Type: string Enum: sqcif qcif cif 4cif 16cif |
|
framerate
Type: number Minimum: True Maximum: 120 |
Specifies the video frames per second |
merge
Type: boolean |
Allows to merge the input files to a single video |
mirror
Type: string Enum: none horizontal vertical |
Mirror/flip your video |
normalize
Type: boolean Default: False |
Normalize the audio volume. |
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. |
overlays
Type: array Additionalproperties: False Input_id: string ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ 1 Define the input_id of the file you want to specify as an overlay. Valid files are videos and images Position_x: integer -100000 100000 The position of the overlay on the x-axis Position_y: integer -100000 100000 The position of the overlay on the y-axis Origin: string Top-left: Top-right: Bottom-left: Bottom-right: Center: Specify the origin for the positioning of the overlay. Default is top-left Width: integer 0 100000 The width of the overlay Height: integer 0 100000 The height of the overlay Opacity: string ^[0,1]$|^0\.\d{1,2}$ Define the opacity of the overlay where 0 is invisible and 1 is full opacity |
|
preset
Type: string Pattern: ^[\w\W]{1,255}$ |
Predefined options |
remove_audio
Type: boolean Default: False |
Disable the audio track |
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 |
video_bitrate
Type: integer Minimum: True Maximum: 100000 |
Specifies the bitrate in kbps |
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/video/mp4/example_small.mp4"
}],
"conversion": [{
"category": "video",
"target": "3gp",
"options": {
<conversion options here>
}
}]
}