imagepeek: compute an image's BlurHash
image_blurhashRead-onlyIdempotent
imagepeek: Generate a BlurHash placeholder string for an image. Returns the BlurHash string of an image (the published woltapp algorithm, identical to the reference package), with x_components and y_components 1-9 (default 4 x 3), for blurred placeholders while the real image loads. Input: url or image_base64, optional x_components, y_components and auto_orient. Reads PNG, JPEG, WebP, GIF, TIFF, BMP, ICO and AVIF; other formats and images over 40 megapixels are refused (not charged). Images are never logged or stored. Typically 0.5-2 s. Price: USD 0.002. Free: 3 imagepeek calls per IP per UTC day.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | Public http(s) URL of the image (at most 10 MB; private, internal and IP-literal hosts are refused); or use image_base64. | |
| auto_orient | No | Apply the EXIF orientation first (default true). | |
| image_base64 | No | The image as standard or url-safe base64 (at most 10 MB decoded; a data:image/...;base64, prefix is fine); or use url. | |
| x_components | No | Horizontal components (1-9, default 4): more detail, a longer hash. | |
| y_components | No | Vertical components (1-9, default 3). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object. | |
| input | No | ||
| notes | No | ||
| source | No | ||
| blurhash | No | ||
| final_url | No | ||
| operation | No | ||
| source_url | No | ||
| x_components | No | ||
| y_components | No |