Rendered sprite sheet image (WebP) — same parameters as the manifest
const url = 'https://gib.show/sprite/example/example/sheet?size=32&cols=25&limit=500&content=mixed&scale=1&gap=0&bg=ffffff&shape=circle&contrast=dark';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://gib.show/sprite/example/example/sheet?size=32&cols=25&limit=500&content=mixed&scale=1&gap=0&bg=ffffff&shape=circle&contrast=dark'Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Provider slug (e.g. pulsex, coingecko, trustwallet; user submissions are prefixed user-).
Provider’s list slug (e.g. extended).
Query Parameters
Section titled “Query Parameters”Cell size in CSS pixels.
Grid columns.
Maximum tokens. A request with a plate is cut to 500.
Content=mixed inlines vector images as data addresses instead of placing them on the grid.
Filter to one chain.
Sheet pixels per CSS pixel. 2 draws the sheet at twice the resolution for dense screens; positions and sizes stay in CSS pixels. Any value other than 2 means 1.
Space between cells, in CSS pixels, so neighbouring logos do not touch and a scaled page cannot bleed one into another. Scaled with the sheet. Any value outside 0 to 32 answers 400.
Paint a plate of this colour behind the logo: 3, 6 or 8 hex digits without #, the last two of eight being alpha (for example ffffff, f80, 00000080). Any other value answers 400. A vector image stays a vector (image/svg+xml) unless as asks for pixels. With as=svg, a vector image that has no usable viewBox cannot take a plate as a vector, and the answer is 404 and not a png. A plate drawn to pixels is never wider than 2048 pixels: a larger logo is shrunk to fit. With contrast as well, bg is the plate colour and contrast decides whether the plate appears.
The outline of the plate. Only used together with bg or contrast; on its own it is checked and then ignored. Any other value answers 400.
Say whether your page is dark or light. Gib looks at what share of the visible pixels of the logo have at least 3:1 contrast with that page, and adds a plate in the opposite tone (light on dark, dark on light) only when that share is under 25 percent, so a logo with some strong parts is left alone. Otherwise the image is served as if the parameter were absent. If the logo cannot be measured, the plain image is sent with cache-control: no-store. Any other value answers 400.
The layout version the manifest gave (its version field). Optional. When it no longer matches the current layout the answer is 409, so no client pairs one layout with another sheet.
Responses
Section titled “Responses”WebP sheet with x-sprite-* metadata headers, including x-sprite-version. Kept a day when pinned by v, and five minutes otherwise.
No raster tokens to render.
A gap, plate colour, shape or tone that is not valid.
object
Example generated
{ "error": "example"}Unknown provider or list.
object
Example generated
{ "error": "example"}The layout named by v is no longer current. Read the manifest again. The answer is never a redirect, which would pair one layout with another sheet.
object
Example generated
{ "error": "example"}This caller, or every caller together, has spent the sheet budget for the window. A sheet costs one unit per cell drawn (two for a plated cell), and the budget is spent only when a sheet is actually drawn. Retry-After says when it renews, in seconds, and the answer is never cached.
object
Example generated
{ "error": "example"}Headers
Section titled “Headers”Too many sheets are being drawn at once. Retry-After says how long to wait, in seconds, and the answer is never cached.
object
Example generated
{ "error": "example"}