Name: add-watermark
Price: 0.02 USDC
Availability: InStock

$ man add-watermark

agentutility / mediakit / add-watermark

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

mediakit

CATEGORY

uncategorized

STATUS

● live

NAME

add-watermark — stamp a text or image watermark onto a pdf, image, or video file

synonym alias of watermark — reuses the canonical handler.

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Stamp a text or image watermark onto a PDF, image, or video file. Send a file_url plus either text or image_url, with optional position, opacity, font, rotation, and margin controls, and it runs the CloudConvert watermark task and returns an output_url in the same format as the input. Covers PDFs, common raster formats like PNG/JPG/GIF/WEBP, and video formats like MP4/MOV/WEBM. Use it as a watermarking API, PDF stamping tool, or video/image branding overlay endpoint.

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	—
watermark_type	string	—
input_format	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/add-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 add-watermark tool from your MCP-aware agent.

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

METADATA

tags: mediakitaddwatermarkadd-watermark
methods: POST
cluster: mediakit
price: $0.02 USDC per call

ADJACENT — other endpoints in mediakit

endpoint	description	price
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
mp4-to-mp3-converter	Converts MP4 video URLs into hosted MP3 files with selectable bitrate; also accepts MOV, WEBM, MKV, AVI, M4V, or FLV URLs.	$0.02