{"uid":"cap_5gyRR5VIwuvWk0Fow_T7b","slug":"x402-image-tools-watermark-text-overlay-ce0db832","name":"x402 Image Tools – Watermark / Text Overlay","description":"Draw a line of text over an image at a corner, an edge or the center, with a size relative to the image width, a color and an opacity.","url":"https://7fg5bxb40m3f0v23.68r.lambda-web.us-east-1.on.aws/v1/watermark?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","description":"https URL of a JPEG, PNG, WebP, AVIF, GIF, TIFF or SVG image (up to 20 MB, 40 megapixels)"},"size":{"type":"number","description":"font size in percent of the image width (1-20, default 4)"},"text":{"type":"string","description":"the text (up to 100 characters; Latin, Greek, Cyrillic and common symbols)"},"color":{"type":"string","description":"hex color (default #ffffff)"},"format":{"enum":["webp","avif","png","jpeg","gif","tiff"],"type":"string","description":"output format (default: the input's)"},"inline":{"type":"boolean","description":"also return the image as a data URL when it is at most 1 MB"},"opacity":{"type":"number","description":"0.05-1 (default 0.5)"},"position":{"enum":["top-left","top","top-right","left","center","right","bottom-left","bottom","bottom-right"],"type":"string","description":"where (default bottom-right)"}}},"responseSchema":{"type":"json","example":{"url":"https://dn8i8p8knpn68.cloudfront.net/results/images/3f1c2b9e.webp?Expires=...","bytes":48213,"width":800,"format":"webp","height":600,"expires_in":3600,"input_bytes":912345}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6r9jXu3KwKDN07BhmtEGV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Draws a line of text over an image at a specified position, size, color, and opacity, returning a new image with the watermark applied.","exampleAgentPrompt":"Add the text '© 2025 Acme Corp' as a white watermark at the bottom-right corner of this image https://example.com/photo.jpg, using 5% font size and 0.6 opacity, and return it as a WebP.","exampleUseCases":[{"title":"Copyright stamp on product photos","prompt":"Watermark all my product photos with '© MyBrand 2025' in white at the bottom-right, 4% font size, 50% opacity — start with this one: https://myshop.com/images/product1.jpg"},{"title":"Caption overlay for social media","prompt":"Add the caption 'Summer Sale – Up to 50% Off' in the center of this banner image https://cdn.example.com/banner.png using a red color (#ff0000) at 80% opacity and 8% font size, output as PNG."},{"title":"Confidential label for internal docs","prompt":"Put the word 'CONFIDENTIAL' diagonally… actually, place it in the top-left corner of this document screenshot https://files.internal.com/report-preview.png in semi-transparent gray (#888888) at 0.3 opacity and 6% size."}],"resultDescription":"A JSON object containing a CDN URL to the watermarked image (valid for ~1 hour), output format, width, height, file size in bytes, input file size, and optionally a data URL of the image if it is under 1 MB and inline was requested.","failureModes":["Image URL unreachable or not a supported format (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG) returns an error","Image exceeds 20 MB or 40 megapixel limit","Text longer than 100 characters rejected","Font size outside 1–20% range rejected","Opacity outside 0.05–1 range rejected","Non-hex color value causes a validation error","Payment of 0.003 USDC not received causes 402 Payment Required","Result URL expires after 3600 seconds"],"whenToPreferThis":"Choose this endpoint when you need to programmatically add a text watermark or annotation to an existing image at a specific position with configurable styling (color, opacity, size). It is the right choice for copyright stamping, branding overlays, caption placement, or confidentiality labels on photos or document screenshots. Prefer it over general image editing pipelines when the only transformation needed is text overlay.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:32.288Z","isFirstParty":false,"canonicalSlug":"x402-image-tools-watermark-text-overlay-ce0db832"}