{"uid":"cap_UtA0q_wZ3rL-Kd_ZxSqDq","slug":"x402-image-tools-watermark-text-overlay-1add44ef","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://image.kagurazaka.dev/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_EJdBECPqEmNoFJlhPt9aT","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 the watermarked image.","exampleAgentPrompt":"Add a semi-transparent white watermark that says '© Morning Bloom 2025' to the bottom-right corner of this image (https://example.com/photo.jpg) — make the text 5% of the image width and 60% opacity, and return it as a WebP.","exampleUseCases":[{"title":"Copyright branding on product photos","prompt":"Stamp '© Acme Store 2025' in white at the bottom-right of this product photo (https://myshop.com/images/chair.jpg), font size 4% of the image width, 50% opacity, and give me back a WebP."},{"title":"Photographer credit on shared images","prompt":"Add 'Photo by Jane Doe' in the bottom-left corner of https://gallery.example.com/landscape.png — use a yellow color (#FFD700), 70% opacity, and text size of 3% of the width."},{"title":"Draft watermark across image center","prompt":"Put the word 'DRAFT' in red (#FF0000) right in the center of this image (https://design.agency.com/mockup.png), make it large — about 10% of the image width — and keep it at 40% opacity so the content still shows through."}],"resultDescription":"A JSON object containing a temporary CDN URL to the watermarked image, its width and height in pixels, output format, file size in bytes, and an expiry duration in seconds. If the result is under 1 MB and inline was requested, a base64 data URL is also included.","failureModes":["Image URL not reachable or returns non-image content (HTTP error or invalid MIME type)","Image exceeds 20 MB or 40 megapixels size limit","Text exceeds 100 characters or contains unsupported character sets (non-Latin/Greek/Cyrillic)","Font size outside 1–20 range or opacity outside 0.05–1 range","Invalid hex color format","Unsupported input image format","x402 payment not fulfilled or insufficient USDC balance"],"whenToPreferThis":"Choose this endpoint when you need to programmatically add text (copyright notices, credits, labels, draft stamps) to an existing image at a specific position with fine-grained control over font size relative to image dimensions, color, and opacity. It is ideal for bulk content pipelines, e-commerce photo workflows, or any scenario where consistent text branding must be applied to images fetched from URLs. Prefer it over full image editors when you need a fast, single-operation, pay-per-use text overlay without setting up local tooling.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:32:53.886Z","isFirstParty":false,"canonicalSlug":"x402-image-tools-watermark-text-overlay-1add44ef"}