{"uid":"cap_aUkyQ0OLj-W0hW-9NIJVQ","slug":"image-watermark-api-x402-agentutility-ai-3c8aa580","name":"Image Watermark API (x402.agentutility.ai)","description":"Image watermark / add text or logo watermark to image files. Also supports PDFs and videos through the same CloudConvert-backed watermark handler. Configurable opacity, position, rotation, font, and margin.","url":"https://x402.agentutility.ai/image-watermark?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["file_url"],"properties":{"text":{"type":"string","description":"Watermark text. Use this or image_url, not both."},"opacity":{"type":"number","description":"Optional. Watermark opacity, 0-100."},"file_url":{"type":"string","description":"URL of the PDF, image, or video to watermark. Format inferred from extension."},"rotation":{"type":"number","description":"Optional. Watermark rotation in degrees, -360 to 360."},"font_size":{"type":"number","description":"Optional. Watermark text font size, 6-400."},"image_url":{"type":"string","description":"URL of an image to use as the watermark. Use this or text, not both."},"font_color":{"type":"string","description":"Optional. Text color as 6-digit hex, e.g. '#FF0000'."},"position_vertical":{"enum":["top","center","bottom"],"type":"string","description":"Optional. Vertical placement: 'top', 'center', or 'bottom'."},"position_horizontal":{"enum":["left","center","right"],"type":"string","description":"Optional. Horizontal placement: 'left', 'center', or 'right'."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"output_url":{"type":"string"},"input_format":{"type":"string"},"watermark_type":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"output_url":"https://...pdf","input_format":"pdf","watermark_type":"text"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OHUfUpGdOni1kAVB-gSSU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Adds a text or logo/image watermark to image, PDF, or video files with configurable opacity, position, rotation, font, and color.","exampleAgentPrompt":"Can you watermark this image at https://example.com/photo.jpg with the text 'Confidential', placed in the bottom-right corner, rotated -30 degrees, at 50% opacity, in red (#FF0000)?","exampleUseCases":[{"title":"Copyright-protect portfolio images","prompt":"Add a semi-transparent watermark with the text '© MyStudio 2025' centered on this image at https://mybucket.s3.amazonaws.com/portfolio/shot1.jpg — 40% opacity, white text, no rotation."},{"title":"Brand proposal PDFs with company logo","prompt":"Stamp our company logo from https://mysite.com/assets/logo.png onto this PDF at https://docs.example.com/proposal.pdf — place it in the bottom-right corner at 30% opacity."},{"title":"Mark confidential documents before sharing","prompt":"Add a diagonal 'CONFIDENTIAL' watermark in red (#FF0000) to this PDF at https://files.example.com/report.pdf — rotate it 45 degrees, font size 80, centered both horizontally and vertically, at 60% opacity."}],"resultDescription":"A JSON object containing output_url (a URL to the watermarked file), input_format (e.g. 'pdf', 'jpg', 'mp4'), and watermark_type (either 'text' or 'image'), allowing the agent to download or share the processed file.","failureModes":["Invalid or inaccessible file_url returns an error (e.g. 404 on the source file)","Both text and image_url provided simultaneously — only one should be used","Unsupported file format inferred from URL extension","Opacity or rotation values out of allowed range cause validation errors","CloudConvert backend timeout for large video files","Payment failure via x402 protocol if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need to programmatically watermark images, PDFs, or videos with either text or a logo image, with fine-grained control over opacity, position, rotation, and font styling. It's particularly useful for automating content protection workflows, branding document pipelines, or marking files as confidential before distribution. Prefer this over generic image editing APIs when you need watermark-specific features backed by CloudConvert's reliable processing engine.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-09-25T14:55:05.584Z","lastSuccessfullyRanAt":"2026-09-25T14:55:05.584Z","lastHealthCheckAt":"2026-10-19T00:50:28.359Z","isFirstParty":false,"canonicalSlug":"image-watermark-api-x402-agentutility-ai-3c8aa580"}