Convert anything to 3GP


The API for converting any file to 3GP.

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
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
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

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/video/mp4/example_small.mp4"
    }],
    "conversion": [{
        "category": "video",
        "target": "3gp",
        "options": {
            <conversion options here>
        }
    }]
}