Skip to main content
POST
Adjust image, video, or audio

Authorizations

Authorization
string
header
required

Dashboard-generated Convertly API key. Keys currently begin with cvly_.

Body

multipart/form-data

Applies brightness/saturation/hue/contrast filters to images and video, or volume/normalize/fade to audio. The accepted properties depend on the input MIME type.

file
file

Multipart upload input.

sourceUrl
string<uri>

Remote HTTP(S) file input. Use instead of file for single-file tools.

async
enum<string>
default:false

Set true to queue the media tool as a background job.

Available options:
true,
false
background
enum<string>

Alias for async=true.

Available options:
true,
false
format
enum<string>

Image: png, webp, jpg. Video: mp4, webm, mov. Audio: mp3, m4a, wav.

Available options:
png,
webp,
jpg,
mp4,
webm,
mov,
mp3,
m4a,
wav
quality
integer
default:86

Image only.

Required range: 1 <= x <= 100
brightness
number
default:1

Image and video. 1 = unchanged. 0.5 = darker. 1.5 = brighter.

saturation
number
default:1

Image and video. 1 = unchanged. 0 = grayscale. 2 = vibrant.

hue
number
default:0

Image and video. Degrees to rotate hue (-180 to 180).

contrast
number
default:1

Image and video. 1 = unchanged.

grayscale
enum<string>
default:false

Image and video.

Available options:
true,
false
sharpen
enum<string>
default:false

Image only.

Available options:
true,
false
invert
enum<string>
default:false

Image and video.

Available options:
true,
false
volume
number
default:1

Audio only. 1 = unchanged. 2 = doubled (server can boost up to 4x).

normalize
enum<string>
default:false

Audio only. Apply EBU R128 loudness normalization.

Available options:
true,
false
fadeIn
number
default:0

Audio only. Fade-in duration in seconds.

fadeOut
number
default:0

Audio only. Fade-out duration in seconds.

Response

Generated files or queued media tool job

files
object[]
required
Last modified on July 28, 2026