GET /capabilities

Discovery endpoint — Tier 2. Agents call this to understand what perstudio can do before making generation requests. No authentication required.

Request

Terminal

curl https://api.perstudio.dev/capabilities

Response

200 OK

{
  "service": "perstudio",
  "version": "0.2.2",
  "capabilities": {
    "generation_categories": [
      "product_photography",
      "portrait",
      "landscape",
      "style_transfer",
      "controlnet_depth",
      "controlnet_canny",
      "ip_adapter",
      "img2img",
      "upscale",
      "video",
      "sticker",
      "logo",
      "text_overlay"
    ],
    "supported_aspects": ["1:1", "16:9", "9:16", "4:3", "3:4"],
    "max_resolution": 2048,
    "accepts_reference_images": true,
    "accepts_control_images": true
  },
  "workflow_count": 14,
  "endpoints": {
    "generate": "POST /generate — intent-based (Tier 1)",
    "workflows": "GET /workflows — list all (Tier 3)",
    "run": "POST /workflows/{id}/run — direct run (Tier 3)"
  }
}

Usage with agents

An agent can call /capabilities during its planning phase to decide whether perstudio can handle a given image generation task. This is especially useful for:

Checking if a specific generation category is supported
Understanding input format requirements
Discovering Tier 3 endpoints for advanced control