HomeAPI ReferenceWebsite Assets

Website Assets

Point POST /api/v1/website-assets at any URL and get back a set of pixel-art animations themed on that site's branding - the same engine behind the Brand Pixelizer tool, available programmatically.

Endpoint2 CREDITS

POST https://webassets.art/api/v1/website-assets

Reads the target site's colors, fonts, and copy, proposes 4 brand-themed sprite ideas, and generates a 4-frame looping animation for each - 2 credits total for the whole batch of 4. Unlike the free, unauthenticated browser tool, this endpoint requires an API key, charges credits, and saves every result to your account - they show up in My Assets like any other generation.

This request runs synchronously - it returns once all 4 animations have finished generating, which typically takes 30-90 seconds.

Request Body

ParameterTypeRequiredDescription
urlstringYESThe website to theme the animations on, e.g. "stripe.com"

Example Request

curl -X POST https://webassets.art/api/v1/website-assets \
-H "Authorization: Bearer mr_live_..." \
-H "Content-Type: application/json" \
-d '{"url": "stripe.com"}'

Response

{
"assets": [
{
"id": "asset_abc123",
"name": "a payment card (stripe.com)",
"imageUrl": "data:image/png;base64,..."
},
...4 total
],
"creditsCharged": 2,
"creditsRemaining": 42
}
FieldTypeDescription
assetsarrayThe 4 generated animations, each saved as an asset in your account
assets[].imageUrlstringA 2x2 grid sprite sheet (4 animation frames) as a base64 data URL
creditsChargednumberAlways 2 for this endpoint
creditsRemainingnumberYour balance after this generation

Errors

Credits are charged before generation starts and automatically refunded if the whole batch fails (e.g. every image generation attempt errors out) - you're never charged for a request that returns an error.

StatusMeaning
401Missing or invalid API key
400Missing or invalid url
402Not enough credits - this endpoint needs 2
502Generation failed (credits refunded)