{
  "service": "api-placeholder",
  "description": "SVG placeholder images for layouts, prototypes, and CMS defaults.",
  "limits": {
    "width_height_px": [
      1,
      2000
    ],
    "max_text_chars": 120,
    "max_batch_items": 50
  },
  "endpoints": {
    "docs_html": "GET /",
    "image_unversioned": "GET /{width}x{height} or GET /{size} (square)",
    "image_versioned": "GET /v1/{width}x{height}",
    "spec": "GET /v1/spec?w=&h=",
    "validate": "GET /v1/validate?w=&h=",
    "presets": "GET /v1/presets",
    "batch": "GET /v1/batch?items=400x300,200x200 (max 50)",
    "embed_widget": "GET /embed/",
    "discovery": "GET /meta"
  },
  "query_params": {
    "text": "Optional centered label (max 120 chars).",
    "bg": "Background hex #rgb or #rrggbb (default #e2e8f0).",
    "fg": "Foreground hex (default #64748b).",
    "theme": "Shorthand color preset. One of: dark, light, gray, blue, green, red. Overridden by explicit fg/bg."
  },
  "examples": {
    "basic": "https://placeholder.tools.town/400x300",
    "labeled": "https://placeholder.tools.town/600x400?text=Hero",
    "tinted": "https://placeholder.tools.town/320x240?bg=%231e293b&fg=%2394a3b8",
    "themed_dark": "https://placeholder.tools.town/800x450?theme=dark",
    "themed_blue": "https://placeholder.tools.town/800x450?theme=blue&text=Loading",
    "versioned": "https://placeholder.tools.town/v1/800x450"
  }
}