{"uid":"cap_1PLTRUDHIijmm4affz70x","slug":"x402-image-tools-smart-thumbnail-generator-3c31a519","name":"x402 Image Tools – Smart Thumbnail Generator","description":"A square thumbnail of an image, smart-cropped around its most interesting region, as WebP by default.","url":"https://7fg5bxb40m3f0v23.68r.lambda-web.us-east-1.on.aws/v1/thumbnail?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":"integer","description":"side in pixels (16-1024, default 256)"},"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"}}},"responseSchema":{"type":"json","example":{"url":"https://dn8i8p8knpn68.cloudfront.net/results/images/3f1c2b9e.webp?Expires=...","bytes":48213,"width":256,"format":"webp","height":256,"expires_in":3600,"input_bytes":912345}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Icd8-d36A6e_TA5ydOIuG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a square, smart-cropped thumbnail of an image from a URL, outputting it as WebP (or another format) by default.","exampleAgentPrompt":"Can you create a 512x512 square thumbnail of this image — https://example.com/photo.jpg — smart-cropped around the most interesting region and saved as a WebP?","exampleUseCases":[{"title":"E-commerce product thumbnail generation","prompt":"I need a 256x256 WebP thumbnail smart-cropped from this product photo URL https://mystore.com/products/shirt.png — make sure the main subject stays in frame."},{"title":"Avatar creation from uploaded photo","prompt":"Take this profile picture at https://cdn.myapp.com/users/alice.jpg and make a 128x128 square thumbnail in PNG format, cropped around the face area."},{"title":"Blog post image preview","prompt":"I have this hero image at https://blog.example.com/header.avif and I need a 400x400 WebP thumbnail to use as a preview card — can you smart-crop it for me?"}],"resultDescription":"Returns a JSON object with a signed CDN URL pointing to the generated thumbnail (valid for 3600 seconds), the thumbnail's dimensions (always square), byte size, output format, and optionally an inline data URL if the image is under 1 MB and the inline flag was set. Also includes the original image's byte size.","failureModes":["Image URL not reachable or returns non-2xx — URL fetch error","Image exceeds 20 MB or 40 megapixel limit — payload too large error","Unsupported image format at the source URL — format rejection","Size parameter outside 16–1024 range — validation error","Malformed or non-HTTPS URL — input validation failure","Temporary Lambda cold start causing timeout on first call"],"whenToPreferThis":"Choose this endpoint when you need a square, content-aware cropped thumbnail from a remote image URL, particularly when smart-cropping around the most visually interesting region matters (e.g. faces, subjects). Prefer it over generic resize endpoints when the square aspect ratio and saliency-based crop are requirements. It supports all major image formats and delivers results via a CDN-backed URL.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:32:47.716Z","isFirstParty":false,"canonicalSlug":"x402-image-tools-smart-thumbnail-generator-3c31a519"}