Convert anything to JPG


The API for converting any file to JPG.

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.
antialias
Type: boolean
aspect_ratio
Type: string
Pattern: ^\d{1,6}:\d{1,6}$
Specify the aspect ratio of the image e.g. 16:9. If used, the options width and height are ignored.
black_white_threshold
Type: integer
Minimum: False
Maximum: 255
Sets the black/white threshold. If set to zero, a calculated average threshold is used
color
Type: string
Enum: colored gray monochrome negate 1980 1900
Default: colored
Color to apply the image
colorize_model_name
Type: string
Enum: generic nature_people
Use Artificial Intelligence to colorize old black and white pictures with a specific training model
colorize_render_factor
Type: int
Minimum: 7
Maximum: 40
Use Artificial Intelligence to colorize old black and white pictures with a specific render factor
colorspace
Type: string
Enum: CMYK Gray sRGB
Sets the image's colorspace
compress
Type: string
Enum: none low medium high best
If set, this option tries to compress your file even more with no perceivable loss of quality
crop_bottom
Type: integer
Minimum: False
Maximum: 100000
Crop from the bottom. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
crop_height
Type: integer
Minimum: True
Maximum: 65000
Specifies the height in pixels of the crop area. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
crop_left
Type: integer
Minimum: False
Maximum: 100000
Crop from the left side. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
crop_origin_x
Type: integer
Minimum: False
Maximum: 65000
Specifies the X origin coordinate in pixels of the crop area starting from the upmost left corner of the image. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
crop_origin_y
Type: integer
Minimum: False
Maximum: 65000
Specifies the Y origin coordinate in pixels of the crop area starting from the upmost left corner of the image. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
crop_right
Type: integer
Minimum: False
Maximum: 100000
Crop from the right side. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
crop_top
Type: integer
Minimum: False
Maximum: 100000
Crop from the top. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
crop_width
Type: integer
Minimum: True
Maximum: 65000
Specifies the width in pixels of the crop area. Use either the cropping from crop_top/bottom/left/right or crop_origin_x/y and crop_width/height.
deskew
Type: boolean
despeckle
Type: boolean
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.
dpi
Type: integer
Minimum: 10
Maximum: 1200
Horizontal and vertical density of the image (referred as DPI)
enhance
Type: boolean
equalize
Type: boolean
height
Type: number
Minimum: True
Maximum: 65000
Sets the height of the image in pixels or percentage depending on the resize_unit value
interlace
Type: string
Enum: line plane
Sets the type of interlacing scheme
normalize
Type: boolean
number_of_frames
Type: integer
Minimum: True
Maximum: 500
Specifies the number of frames to extract from a video file
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
quality
Type: integer
Minimum: False
Maximum: 100
Level of quality from 0 (worst quality, smaller file size) to 100 (best quality, greater file size)
resize_by
Type: string
Enum: px perc inches cm mm
Sets the unit of measurement for the image's width and height
resize_handling
Type: string
Enum: stretch keep_aspect_ratio_fill_black keep_aspect_ratio_fill_white keep_aspect_ratio_fill_blurred keep_aspect_ratio_crop
Default: stretch
Determine how the resizing of the image should be done. Either by stretching, keeping the original aspect ratio (filling the empty space if needed) or not upscaling the original image.
resize_unit
Type: string
Enum: px perc
DEPRECATED! Please use resize_by instead.
resolution_unit
Type: string
Enum: none px perc inches cm mm
Default: none
DEPRECATED! Please, use resize_by instead.
rotate
Type: integer
Minimum: True
Maximum: 359
Rotate image to specified degrees
sampling_factor
Type: string
Enum: 4:4:4 4:4:0 4:2:2 4:2:0 4:1:1 4:1:0
Sets the chroma sub-sampling method to use
sharpen
Type: boolean
width
Type: number
Minimum: True
Maximum: 65000
Sets the width of the image in pixels or percentage depending on the resize_unit value

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/raster%20image/png/example_small.png"
    }],
    "conversion": [{
        "category": "image",
        "target": "jpg",
        "options": {
            <conversion options here>
        }
    }]
}