PIpicsart
Edit

Fit Video

Fit your original video to different ratios or width and height options. Apply fit when resizing and cropping is not an option.

post/fit

Request

  • Base URL
    https://video-api.picsart.io/v1
  • URL
    https://video-api.picsart.io/v1/fit
  • Auth
    API key in header X-Picsart-API-Key

Request body

video_urlstring uri

Source video URL.

rationumber float nullable

The value should be a single floating point number which represents the ratio of width and height. The formula is: parameter value = width / height. The default value is that of the original video.

widthinteger nullable

Width of the outcome video. If the new width is larger than the original width, the blurry mirror effect should be applied to the additional part. The measurement unit is px. The default value is the original width. Value must be at least 16 px.

heightinteger nullable

Height of the outcome video. If the new height is larger than the original height, the blurry mirror effect should be applied to the additional part. The measurement unit is px. The default value is the original height. Value must be at least 16 px.

bg_colorstring nullable

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). (If this parameter is present, the other bg_ parameters must be empty).

bg_blurinteger

Enter an integer value from 0 to 100.

bg_image_urlstring uri

Background image URL.

bg_video_urlstring uri

Background video URL.

Response

Request successfully accepted for an asynchronous transformation.

transaction_idstring nullable
status'success' | 'error' | 'processing' | 'queued'

Changes

No recorded changes to this operation across all 1 revision of this API.