Picsart Video AI icon

Picsart Video AI

Generate images and stickers with Picsart API: generate from prompt

Actions11

Video → Add Watermark

AI-generated

Summary

Adds a watermark image to a video via URL or binary upload with configurable positioning, size, opacity, rotation, and padding.

Inputs

  • videoUrl (required) — Source video URL (WEBM, MP4, or MOV, max 100MB, max 1920x1080).
  • watermarkSource (required) — Source of the watermark image: 'url' for a web URL or 'binary' for an image file in a binary property.
  • watermarkUrl — Watermark image URL (required if Watermark Source is 'url').
  • watermarkBinaryPropertyName — Name of the binary property containing the watermark image (required if Watermark Source is 'binary').
  • anchorPoint — Position of the watermark on the video (default: 'center-middle').
  • watermarkWidth — Width of the watermark in pixels (≥ 1, advanced mode only).
  • watermarkHeight — Height of the watermark in pixels (≥ 1, advanced mode only).
  • watermarkOpacity — Opacity of the watermark (0–100, default 50, advanced mode only).
  • watermarkAngle — Rotation angle of the watermark in degrees (0–360, advanced mode only).
  • watermarkPaddingX — Horizontal padding of the watermark (≥ 0, advanced mode only).
  • watermarkPaddingY — Vertical padding of the watermark (≥ 0, advanced mode only).
  • exportFormat — Output video format (MP4, MOV, or WEBM, advanced mode only).
  • mode — Execution mode: 'simple' (default) or 'advanced' (for extra parameters).

Output shape

A single output item containing a binary data field with the watermarked video and a JSON object with metadata.

The operation uses a multipart/form-data request to upload the watermark image (either as a URL or binary buffer) to the Picsart API, processes it, and returns the resulting video as a downloadable binary item. The API uses a polling mechanism (up to 600 attempts) to retrieve the processed video.

Examples

Example 1: Add a logo to the top-left corner of a video using a URL.

Video URL: https://example.com/video.mp4, Watermark Source: url, Watermark URL: https://example.com/logo.png, Anchor Point: left-top, Mode: simple.

Example 2: Overlay a semi-transparent watermark image from the workflow's binary data.

Video URL: https://example.com/video.mp4, Watermark Source: binary, Binary Property Name: data, Anchor Point: center-middle, Watermark Opacity: 50, Mode: simple.

Example 3: Add a watermark with custom size and rotation in advanced mode.

Video URL: https://example.com/video.mp4, Watermark Source: url, Watermark URL: https://example.com/watermark.png, Anchor Point: center-middle, Watermark Width: 100, Watermark Height: 100, Watermark Angle: 45, Export Format: MP4, Mode: advanced.

Links

Discussion