Skip to main content
POST
/
api
/
media
/
adjust
Adjust image, video, or audio
curl --request POST \
  --url https://convertly.sh/api/media/adjust \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'sourceUrl=<string>' \
  --form async=false \
  --form quality=86 \
  --form brightness=1 \
  --form saturation=1 \
  --form hue=0 \
  --form contrast=1 \
  --form grayscale=false \
  --form sharpen=false \
  --form invert=false \
  --form volume=1 \
  --form normalize=false \
  --form fadeIn=0 \
  --form fadeOut=0
{
  "files": [
    {
      "filename": "<string>",
      "mimeType": "<string>",
      "originalSize": 123,
      "finalSize": 123,
      "downloadUrl": "<string>"
    }
  ]
}

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