# Agentic Diagrams – Architecture Diagram Generator

> Agentic Diagrams – Architecture Diagram Generator is a paid API for AI agents from agentic-diagrams-production.up.railway.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Generates self-contained animated architecture diagrams as HTML, SVG, MP4, WebM, GIF, or PNG from a node/edge graph definition

## Facts

- Endpoint: POST https://agentic-diagrams-production.up.railway.app/v1/diagrams?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentic-diagrams-architecture-diagram-generator-116b5042
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_srWGPta5OlUPE2LnGk62G

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentic-diagrams-architecture-diagram-generator-116b5042 -d '<json body>'
```

Example prompt: Create an animated circuit-style architecture diagram in dark mode showing three nodes: an API Gateway (kind: gateway, status: working), a Payment Service (kind: service, status: working), and a Database (kind: database, status: ready), with edges from API Gateway to Payment Service labeled 'routes' and from Payment Service to Database labeled 'reads/writes' — export it as a 1280x720 HTML file with the title 'Payment Flow'.

## When to prefer this

Choose this endpoint when you need a programmatically generated, visually polished architecture or system diagram with animation support and multiple export formats — especially when the output needs to be embedded in a web page (HTML/SVG), shared as a video (MP4/WebM/GIF), or included in a report (PNG). It is ideal when you have a structured list of components and their connections and need a quick, self-contained visual without running a local diagramming tool. Prefer this over static SVG libraries when animation, status indicators, or video export is needed.

## Known failure modes

- Invalid node ID pattern (must match ^[a-zA-Z0-9_-]{1,48}$) returns a 400 validation error
- Too many nodes (>60) or edges (>120) returns a 400 error
- Unsupported format enum value returns a 400 error
- Dimensions not a multiple of 2 returns a 400 error
- Payment not attached or insufficient USDC returns a 402 error
- Rendering timeout for complex animated video exports may return a 500 error
- Missing required node fields (id, label) returns a 400 error

## How this service works

Generate a self-contained animated architecture diagram as HTML, SVG, MP4, WebM, GIF or PNG

## Output

The endpoint returns the diagram as a binary or text payload in the requested format (HTML, SVG, MP4, WebM, GIF, or PNG). HTML and SVG are self-contained and embeddable. Video/image formats are binary files ready for download or display. The diagram visually represents the provided nodes with status indicators and edges with optional labels, rendered in the selected style and color scheme at the specified dimensions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "edges": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "from",
     "to"
    ],
    "properties": {
     "to": {
      "type": "string"
     },
     "from": {
      "type": "string"
     },
     "label": {
      "type": "string",
      "default": "",
      "maxLength": 60
     }
    },
    "additionalProperties": false
   },
   "default": [],
   "maxItems": 120
  },
  "nodes": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "label"
    ],
    "properties": {
     "id": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{1,48}$"
     },
     "kind": {
      "type": "string",
      "default": "component",
      "maxLength": 40
     },
     "label": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1
     },
     "detail": {
      "type": "string",
      "default": "",
      "maxLength": 200
     },
     "status": {
      "enum": [
       "working",
       "ready",
       "waiting",
       "blocked",
       "unknown"
      ],
      "type": "string",
      "default": "ready"
     }
    },
    "additionalProperties": false
   },
   "maxItems": 60,
   "minItems": 1
  },
  "style": {
   "enum": [
    "orbital",
    "circuit",
    "ledger"
   ],
   "type": "string",
   "default": "circuit"
  },
  "title": {
   "type": "string",
   "maxLength": 120,
   "minLength": 1
  },
  "export": {
   "type": "object",
   "default": {},
   "properties": {
    "fps": {
     "anyOf": [
      {
       "type": "number",
       "const": 10
      },
      {
       "type": "number",
       "const": 20
      },
      {
       "type": "number",
       "const": 24
      },
      {
       "type": "number",
       "const": 25
      },
      {
       "type": "number",
       "const": 30
      }
     ],
     "default": 20
    },
    "width": {
     "type": "integer",
     "default": 1280,
     "maximum": 1920,
     "minimum": 320,
     "multipleOf": 2
    },
    "height": {
     "type": "integer",
     "default": 720,
     "maximum": 1080,
     "minimum": 240,
     "multipleOf": 2
    },
    "durationSeconds": {
     "type": "integer",
     "default": 6,
     "maximum": 12,
     "minimum": 1
    }
   },
   "additionalProperties": false
  },
  "format": {
   "enum": [
    "html",
    "svg",
    "mp4",
    "webm",
    "gif",
    "png"
   ],
   "type": "string",
   "default": "html"
  },
  "animated": {
   "type": "boolean",
   "default": true
  },
  "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentic-diagrams-architecture-diagram-generator-116b5042/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentic-diagrams-production.up.railway.app](https://www.zero.xyz/host/agentic-diagrams-production.up.railway.app/llms.txt)