{"uid":"cap_8Pl3wcOzTOGX54-4Si-V0","slug":"relaystation-image-composite-a22135ae","name":"RelayStation Image Composite","description":"$0.0003/MP. Overlay or watermark one image onto another — position and blend control. 1¢ x402 min; remainder auto-credits — relaystation.ai/penny","url":"https://api.relaystation.ai/v1/image/composite","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":{"type":"object","properties":{"top":{"type":"integer","maximum":100000,"minimum":0},"file":{"type":"object","description":"The base image. cputools input-source: { inline: <base64 ≤ 4 MiB> } or { inputKey: <scratch key from /v1/cputools/upload-url, ≤ 50 MB> }."},"left":{"type":"integer","maximum":100000,"minimum":0},"gravity":{"enum":["center","north","south","east","west","northeast","northwest","southeast","southwest"],"type":"string","description":"Overlay placement (alternative to top/left)."},"opacity":{"type":"number","maximum":1,"minimum":0},"overlay":{"type":"object","description":"The overlay image. cputools input-source: { inline: <base64 ≤ 4 MiB> } or { inputKey: <scratch key from /v1/cputools/upload-url, ≤ 50 MB> }."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZCJjR_ramCggJ9SvVWUND","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Overlays or watermarks one image onto another with configurable position and blend control","exampleAgentPrompt":"Take my product photo and overlay my company logo watermark onto the bottom-right corner with 70% opacity to create a branded composite image.","exampleUseCases":[{"title":"Brand watermarking for product photos","prompt":"I have a product image and I want to stamp our company logo in the bottom-right corner at 60% opacity — can you composite them together?"},{"title":"Adding badge overlay to profile picture","prompt":"Take this profile photo and overlay this 'verified' badge image in the top-right corner at full opacity."},{"title":"Creating sponsored content watermark","prompt":"Overlay our sponsor's banner image onto the bottom of this event photo, centered horizontally, with 80% blend opacity."}],"resultDescription":"Returns a composited image file with the overlay image blended onto the base image at the specified position and opacity. Charged at $0.0003 per megapixel with a $0.01 minimum via x402 payment; any remainder auto-credits to the account.","failureModes":["Invalid or inaccessible image URL returns an error","Unsupported image format causes processing failure","Position coordinates out of bounds may clip the overlay","Insufficient x402 payment balance halts processing","Overlay image larger than base image may produce unexpected results"],"whenToPreferThis":"Choose this endpoint when you need to programmatically composite, watermark, or overlay one image on top of another with control over position and blend/opacity. Ideal for automated branding pipelines, batch watermarking workflows, or any agent task requiring image layering at a low per-megapixel cost with micropayment x402 billing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:30:16.453Z","isFirstParty":false}