REST API

# Fetch vector SVG directly via query parameters
curl -X GET "https://avatars.spaceui.one/v1?name=alex&variant=triton&size=256&circle=true&effect=noise"
# Fetch a high-resolution PNG raster image
curl -X GET "https://avatars.spaceui.one/v1?name=alex&variant=triton&size=512&format=png" -o avatar.png
# Fetch an efficient WebP raster image
curl -X GET "https://avatars.spaceui.one/v1?name=alex&variant=triton&size=512&format=webp" -o avatar.webp

# Clean REST URLs for <img> tags or CMS embeds
https://avatars.spaceui.one/v1/triton/alex.svg?circle=true
https://avatars.spaceui.one/v1/gradients/alex.png?size=256
https://avatars.spaceui.one/v1/gradients/alex.webp?size=256
https://avatars.spaceui.one/v1/alex.json

// GET /v1/schema response
{
  "title": "Space Avatar API",
  "version": "0.1.4",
  "description": "Generative SVG & Raster Avatar Service",
  "defaultSize": 128,
  "supportedFormats": ["svg","png","webp","json"],
  "families": ["gradient", "fluid", "classic", "paletteless"],
  "routes": {
    "restPattern": "/v1/:variant?/:name.:format",
    "queryPattern": "/v1?name=:name&variant=:variant&size=:size&circle=:circle&format=:format",
    "schema": "/v1/schema"
  }
}

// GET /v1/triton/alex.json?circle=true
{
  "name": "alex",
  "variant": "triton",
  "size": 128,
  "circle": true,
  "effect": "none",
  "animate": false,
  "svg": "<svg viewBox=\"0 0 64 64\">...</svg>",
  "dataUri": "data:image/svg+xml;utf8,...",
  "pngDataUri": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "webpDataUri": "data:image/webp;base64,UklGR...",
  "routes": {
    "svg": "/v1/triton/alex.svg?circle=true",
    "png": "/v1/triton/alex.png?circle=true",
    "webp": "/v1/triton/alex.webp?circle=true",
    "json": "/v1/triton/alex.json?circle=true"
  }
}