Name: watermark
Price: 0.02 USDC
Availability: InStock

$ man watermark

agentutility / mediakit / watermark

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

mediakit

CATEGORY

media

STATUS

● live

NAME

watermark — adds a text or image watermark overlay to pdfs, png/jpg/gif images, and mp4/mov/webm videos

SYNOPSIS

POST https://x402.agentutility.ai/watermark
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Adds a text or image watermark overlay to PDFs, PNG/JPG/GIF images, and MP4/MOV/WEBM videos. CloudConvert engine. Configurable position, opacity, font, rotation, and margin. Use it for PDF, image, or video watermarking.

INPUT — request schema

property	type	description	req?
file_url	string	URL of the PDF, image, or video to watermark. Format inferred from extension.	required
text	string	Watermark text. Use this or image_url, not both.	optional
image_url	string	URL of an image to use as the watermark. Use this or text, not both.	optional
font_size	number	Optional. Watermark text font size, 6-400.	optional
font_color	string	Optional. Text color as 6-digit hex, e.g. '#FF0000'.	optional
opacity	number	Optional. Watermark opacity, 0-100.	optional
rotation	number	Optional. Watermark rotation in degrees, -360 to 360.	optional
position_vertical	string	Optional. Vertical placement: 'top', 'center', or 'bottom'. enum: top · center · bottom	optional
position_horizontal	string	Optional. Horizontal placement: 'left', 'center', or 'right'. enum: left · center · right	optional

OUTPUT — response shape

field	type	description
output_url	string	Signed CloudConvert URL of the watermarked file (24h expiry).
file_size_bytes	number	Output file size in bytes.
input_format	string	Detected input format (pdf, png, mp4, etc.).
watermark_type	string	'text' or 'image'.
source_url	string	Echo of the input URL.
job_id	string	CloudConvert job id.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/watermark \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the watermark tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: watermarkpdfimagevideobranding
env: CLOUD_CONVERT_API_KEY
methods: POST
cluster: mediakit
price: $0.02 USDC per call

ADJACENT — other endpoints in mediakit

endpoint	description	price
add-watermark	Stamp a text or image watermark onto a PDF, image, or video file.	$0.02
audio-loudnorm	Normalize audio loudness to a target LUFS level for podcasts, YouTube, and Spotify delivery.	$0.02
csv-to-jsonl	Converts CSV or TSV data into JSON, JSONL/NDJSON, or column-oriented arrays.	$0.02
image-translate	Image translator.	$0.02
image-upscale	Upscales an image 2x or 4x via Venice's image/upscale endpoint (default model: venice-sd35).	$0.02
image-watermark	Image watermark / add text or logo watermark to image files.	$0.02
mp4-to-mp3	Converts MP4, MOV, WebM, MKV, AVI, M4V, and FLV video files to MP3 via CloudConvert, with selectable bitrate (96/128/192 kbps).	$0.02
mp4-to-mp3-api	Converts MP4, MOV, WEBM, MKV, AVI, M4V, or FLV URLs into hosted MP3 output with selectable 96, 128, or 192 kbps bitrate.	$0.02