---
title: Generate Watermark For Videos Job API
slug: generate-video-watermark
url: https://apyhub.com/apyhub/service/generate-video-watermark
provider: ApyHub
categories: [File Conversion, File Manipulation]
tags: [video-watermark, video-processing, watermarking, file-manipulation, media-processing]
auth: api_key
---

# Generate Watermark For Videos Job API

Add text or image watermarks to videos from a URL or file. Poll a job ID for the finished video URL when processing completes.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/job/generate/video/watermark/url` | What it does Submits an async video watermarking job using a source video URL and watermark setting… | 400 |
| POST | `/job/generate/video/watermark/file` | What it does Submits a multipart video file job to generate a video watermark. The request sends th… | 400 |
| GET | `/job/generate/video/watermark/status/:job_id` | What it does Checks the status of a generate video watermark job by job ID. When the job is success… | 400 |

## About

## What it does
Video Watermark Generator adds a text or image watermark to a video and returns an asynchronous job you can poll for the finished file. Submit either a video URL or a multipart video file, choose the watermark type, and retrieve a presigned or CDN URL when processing completes.

Use `watermark_text` for a text overlay, or `watermark_image` for an image overlay. You can control placement with `watermark_position`, adjust transparency with `watermark_opacity`, and tune the look with `watermark_font_size`, `watermark_font_color`, `watermark_text_padding`, and `watermark_text_background_color`. For image watermarks, you can also set `watermark_image_size`; `gif_loop` is available when the watermark is a GIF. The URL-based endpoint also accepts `size` for output scaling and a `persistent` query flag.

The job response returns a `job_id` right away. Poll `GET /jobs/:job_id` to check whether the job is `pending`, `successful`, or `failed`. When it succeeds, the response includes the output `url` for the watermarked video. That makes it a fit for batch processing, content protection, branding, or adding review marks to generated clips without handling video encoding in your own service.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/generate-video-watermark
