API & Agent Control

The studio turns pasted ASCII, ANSI, multi-frame text, JSON/NDJSON streams, and asciicast recordings into reconstructed video. The HTTP API gives scripts, automations, and AI agents the same source parser plus stateless SVG, HTML, ANSI, JSON, NDJSON, and text rendering with CRT styling. Trusted source/WebM handoffs are a browser studio path for preserving original source artifacts without degrading them through ASCII.

Live playground

POST /api/v1/render

ASCII input

Format

Glyph

Backdrop

Glow · 0.6

cURL

curl -X POST /api/v1/render \
  -H "Content-Type: application/json" \
  -d '{"ascii":"___\n   .-''   ''-.\n  /  .-'''-.  \\\n |  /  /_\\  \\  |\n |  |   |   |  |\n  \\  '-...-'  /\n   '-._____.-'\n signal://a2v","format":"svg","monoColor":"#22c55e","background":"#050805","glow":0.6,"scanlines":true}'

Response

Run a request to see the output.

Endpoints

GET/api/healthLiveness + capability probe.

GET/api/v1/healthVersioned platform health probe.

GET/api/docsMachine-readable route and capability docs.

POST/api/v1/renderRender ASCII/asciicast/JSON-stream input to SVG, HTML, ANSI, JSON, NDJSON, or text.

POST/api/mcpModel Context Protocol (JSON-RPC 2.0).

GET/api/v1/agentMachine-readable agent capability manifest.

GET/api/openapi.jsonOpenAPI 3.1 specification.

Render parameters

Param	Type	Default	Description
format	enum	svg	svg \| html \| ansi \| json \| json-stream \| text output artifact.
monoColor	hex	#22c55e	Phosphor / glyph color.
background	hex	#050805	Backdrop color (svg/html).
glow	float 0–1	0.6	CRT phosphor bloom amount (svg/html).
scanlines	boolean	true	Overlay CRT scanlines (svg/html).
fontSize	integer 6–48	14	Cell height in px (svg/html).
gradientTo	hex \| null	null	Optional top→bottom gradient target color.
frame	integer	0	Frame index for multi-frame / .cast input.
trim	boolean	true	Trim blank border rows and columns.

Formats:svghtmlansijsonjson-streamtext

Agents & MCP

POST /api/mcp

The Model Context Protocol endpoint speaks JSON-RPC 2.0 and exposes a single render_ascii tool. Point any MCP-compatible agent at the endpoint, or fetch the agent manifest for ready-to-run recipes.

MCP tool call

curl -X POST /api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "render_ascii",
      "arguments": { "ascii": "signal://a2v", "format": "ansi" }
    }
  }'

Discovery

/llms.txtConcise LLM discovery doc./llms-full.txtFull machine reference./llms-index.jsonStructured LLM discovery index./api/openapi.jsonOpenAPI 3.1 spec./openapi.yamlYAML OpenAPI 3.1 spec./api/v1/agentAgent manifest + recipes./.well-known/trust.jsonPlatPhorm trust and public/protected boundary.