Render Mermaid, Graphviz, D2 or Vega-Lite

POST/v1/render/diagram

RapidAPI ● LiveApyHub ● Live · /diagram

Turn diagram-as-code into SVG, PNG, PDF, JPEG, WebP or a JSON PNG data URI. Choose mermaid, graphviz, d2 or vegalite; syntax failures return a structured error with the source line (and column when the engine reports it).

SVG is the fastest vector output and has no pixel ceiling. Raster and PDF outputs are bounded by the published size limits. Vega-Lite data must be inline, and remote/file-reading features are blocked.

More examples and contract notes

More examples

Graphviz architecture

{
  "engine": "graphviz",
  "source": "digraph G { rankdir=LR; client -> gateway -> renderer; renderer -> cache; }",
  "layout": "dot",
  "format": "png",
  "width": 1200,
  "background": "#ffffff"
}

D2 sequence

{
  "engine": "d2",
  "source": "client -> gateway: request\ngateway -> renderer: render\nrenderer -> client: image",
  "layout": "dagre",
  "format": "svg"
}

Vega-Lite chart

{
  "engine": "vegalite",
  "source": "{\"data\":{\"values\":[{\"month\":\"Jan\",\"sales\":28},{\"month\":\"Feb\",\"sales\":55},{\"month\":\"Mar\",\"sales\":43}]},\"mark\":\"bar\",\"encoding\":{\"x\":{\"field\":\"month\",\"type\":\"nominal\"},\"y\":{\"field\":\"sales\",\"type\":\"quantitative\"}}}",
  "format": "png",
  "width": 800
}

Body parameters

application/json

formatjson · svg · png · pdf · jpeg · webp

Output format. `json` returns a PNG data URI plus metadata and is the default; `svg`/`png`/`pdf`/`jpeg`/`webp` return the bytes.

default "json"

scalenumber

Zoom the output 0.5–4×. Ignored when `width` is set. Raster and PDF output is capped at 8192×8192 px on the hosted plans (WebP 4096×4096); SVG has no ceiling.

default 1min 0.5max 4

widthinteger

Target width in pixels (16–4096); height follows the aspect ratio and must stay within the same pixel ceiling. Overrides `scale`.

min 16max 4096

backgroundstring

Background colour as `#rrggbb`/`#rgb`, a CSS name, or `transparent` for none.

enginemermaid · graphviz · d2 · vegaliteREQUIRED

Diagram engine: `mermaid`, `graphviz`, `d2` or `vegalite` (Vega-Lite JSON spec).

sourcestringREQUIRED

Diagram source: Mermaid text, DOT, D2 or a Vega-Lite JSON spec. ≤ 64 KiB via POST, ≤ 8 KiB via GET. Vega-Lite specs must inline their data (`url` is refused); Graphviz attributes that read local files (`image=`, `shapefile=`, …) are refused.

max length 65536

themestring

layoutstring

Responses

The rendered output

application/json

formatstring

media_typestring

widthinteger

heightinteger

data_uristring

warningsstring[]

enginestring

engine_versionstring

cachehit · miss

render_msinteger

queued_msinteger

image/svg+xml

Binary response body.

image/png

Binary response body.

image/jpeg

Binary response body.

image/webp

Binary response body.

application/pdf

Binary response body.

Render a LaTeX expression

POST/v1/render/math

RapidAPI ● LiveApyHub ● Live · /math

Render TeX with MathJax to vector paths, so the result needs no fonts on the caller. Choose display or inline style, colour, font size and output format.

More examples and contract notes

More examples

Integral as PNG

{
  "tex": "\\int_0^\\infty e^{-x^2}\\,dx = \\frac{\\sqrt{\\pi}}{2}",
  "format": "png",
  "scale": 2,
  "background": "transparent"
}

Body parameters

application/json

formatjson · svg · png · pdf · jpeg · webp

Output format. `json` returns a PNG data URI plus metadata and is the default; `svg`/`png`/`pdf`/`jpeg`/`webp` return the bytes.

default "json"

scalenumber

Zoom the output 0.5–4×. Ignored when `width` is set. Raster and PDF output is capped at 8192×8192 px on the hosted plans (WebP 4096×4096); SVG has no ceiling.

default 1min 0.5max 4

widthinteger

Target width in pixels (16–4096); height follows the aspect ratio and must stay within the same pixel ceiling. Overrides `scale`.

min 16max 4096

backgroundstring

Background colour as `#rrggbb`/`#rgb`, a CSS name, or `transparent` for none.

texstringREQUIRED

TeX source, e.g. `\frac{a}{b}` or `\int_0^\infty e^{-x}\,dx`. ≤ 64 KiB via POST, ≤ 8 KiB via GET.

max length 65536

displayboolean

Display style (centred, larger) vs inline style.

default true

colorstring

Text colour as `#rrggbb`/`#rgb`.

font_sizeinteger

Font size in pixels (6–96).

default 16min 6max 96

Responses

The rendered output

application/json

formatstring

media_typestring

widthinteger

heightinteger

data_uristring

warningsstring[]

enginestring

engine_versionstring

cachehit · miss

render_msinteger

queued_msinteger

image/svg+xml

Binary response body.

image/png

Binary response body.

image/jpeg

Binary response body.

image/webp

Binary response body.

application/pdf

Binary response body.

Render a code screenshot

POST/v1/render/code

RapidAPI ● LiveApyHub ● Live · /code

Turn source code into a syntax-highlighted image with Pygments. Auto-detect the language or provide it, choose a theme, and add line numbers, window chrome and a filename. SVG is recommended for long listings.

More examples and contract notes

More examples

JavaScript SVG

{
  "source": "const greet = (name) => `Hello, ${name}!`;\nconsole.log(greet('Ada'));",
  "language": "javascript",
  "theme": "dracula",
  "format": "svg",
  "line_numbers": true
}

Body parameters

application/json

formatjson · svg · png · pdf · jpeg · webp

Output format. `json` returns a PNG data URI plus metadata and is the default; `svg`/`png`/`pdf`/`jpeg`/`webp` return the bytes.

default "json"

scalenumber

Zoom the output 0.5–4×. Ignored when `width` is set. Raster and PDF output is capped at 8192×8192 px on the hosted plans (WebP 4096×4096); SVG has no ceiling.

default 1min 0.5max 4

widthinteger

Target width in pixels (16–4096); height follows the aspect ratio and must stay within the same pixel ceiling. Overrides `scale`.

min 16max 4096

backgroundstring

Background colour as `#rrggbb`/`#rgb`, a CSS name, or `transparent` for none.

sourcestringREQUIRED

Source code. ≤ 64 KiB via POST, ≤ 8 KiB via GET, ≤ 2000 lines. Long listings fit as `format=svg` (no pixel ceiling); raster output is limited to 8192×8192 px (~380 lines at 1×).

max length 65536

languagestring

Pygments language name, e.g. `python`; auto-detected when omitted.

max length 64

themestring

Pygments style name. Curated: `default`, `friendly`, `monokai`, `dracula`, `github-dark`, `solarized-dark`, `solarized-light`, `nord`, `one-dark`, `gruvbox-dark`; any other Pygments style name is accepted too.

default "default"

line_numbersboolean

Print a line-number gutter.

default false

windowboolean

Draw a macOS-style window title bar.

default false

titlestring

Filename shown in the window bar (implies `window`).

max length 100

Responses

The rendered output

application/json

formatstring

media_typestring

widthinteger

heightinteger

data_uristring

warningsstring[]

enginestring

engine_versionstring

cachehit · miss

render_msinteger

queued_msinteger

image/svg+xml

Binary response body.

image/png

Binary response body.

image/jpeg

Binary response body.

image/webp

Binary response body.

application/pdf

Binary response body.

import os
import httpx

base_url = "https://diagram-math-code-render-api.p.rapidapi.com"
headers = {
    "X-RapidAPI-Key": os.environ["RAPIDAPI_KEY"],
    "X-RapidAPI-Host": "diagram-math-code-render-api.p.rapidapi.com",
}
payload = {
    "engine": "mermaid",
    "source": "graph TD; A[Start] --> B{Ready?}; B -->|yes| C[Ship]; B -->|no| A;",
}
response = httpx.post(
    base_url + "/v1/render/diagram",
    headers=headers, json=payload, timeout=120
)
response.raise_for_status()
print(response.json())

Illustrative response excerpt200

{
  "format": "png",
  "engine": "mermaid"
}

Try this operation Get production API access

Render Mermaid, Graphviz, D2 or Vega-Lite

Body parameters

Responses

Related

Render a LaTeX expression

Body parameters

Responses

Related

Render a code screenshot

Body parameters

Responses

Related