Picsart Video AI icon

Picsart Video AI

Generate images and stickers with Picsart API: generate from prompt

Actions11

Video → Fit Video

AI-generated

Summary

Resizes and reshapes a video to a specified aspect ratio or dimensions, optionally adding a background.

Inputs

  • videoUrl (required) — Source video URL (WEBM, MP4 or MOV, max 100MB, max 1920x1080).
  • fitRatio — Target width/height ratio (0.1–10). e.g., 1.778 for 16:9. Leave empty to keep original.
  • fitWidth — Target width in pixels (≥ 1). Leave empty to use ratio or original.
  • fitHeight — Target height in pixels (≥ 1). Leave empty to use ratio or original.
  • fitBgColor — Hex or color name (e.g., #82d5fa, blue). If set, do not use Background Image/Video URL.
  • fitBgBlur — Background blur intensity (0–100).
  • fitBgImageUrl — Background image URL. If set, do not use Background Color or Background Video URL.
  • fitBgVideoUrl — Background video URL. If set, do not use Background Color or Background Image URL.
  • mode — Execution mode ('simple' or 'advanced').

Output shape

A single processed video item containing binary data and metadata.

The operation returns the output video as a binary file (MP4) and includes metadata such as the result URL and the original input URL in the JSON output.

Examples

Example 1: Resizing a 4:3 video to 16:9 landscape ratio.

Set Video URL and Fit Ratio to 1.778 (16:9).

Example 2: Cropping a video to a specific 1920x1080 resolution.

Set Video URL, Fit Width to 1920, and Fit Height to 1080.

Example 3: Resizing a portrait video to landscape with a blurred background.

Set Video URL, Fit Ratio to 1.778, and Background Blur to 50.

Links

Discussion