📖 ASCII Art Converter — Documentation

POST /api/convert

Convert an inline image or trusted artifact URL to ASCII art. Small output returns inline ASCII; large output returns a real preview, chunks, hashes, and artifact links.

curl -X POST https://ascii.platphormnews.com/api/convert \
  -H "Content-Type: application/json" \
  -d '{
    "image": "data:image/png;base64,...",
    "resolution": 0.11,
    "charset": "standard",
    "grayscale": true,
    "inverted": false
  }'

POST /api/convert/url

Convert a trusted PlatPhorm or Vercel Blob image artifact URL without a key. External or untrusted URLs require PLATPHORM_API_KEY and still pass HTTPS, SSRF, content-type, and size guardrails.

curl -X POST https://ascii.platphormnews.com/api/convert/url \
  -H "Content-Type: application/json" \
  -d '{
    "artifactUrl": "https://browserops.platphormnews.com/artifacts/run/screenshot.png",
    "width": 220,
    "charset": "blocks"
  }'

POST /api/convert/browserops

BrowserOps screenshot artifact conversion. A confirmed BrowserOps or Vercel Blob screenshot URL can be converted publicly inside the PlatPhorm network; run and screenshot IDs are preserved in the artifact metadata.

POST /api/convert/agentui

AgentUI workflow image artifact conversion. Trusted AgentUI, BrowserOps, or Vercel Blob screenshot artifact URLs convert without a key; outbound AgentUI handoff still uses /api/artifacts/{id}/send/agentui and requires PLATPHORM_API_KEY.

POST /api/convert/chunked

Force a temporary chunked ASCII artifact with manifest, chunks, preview, hashes, and export links. The Web UI Stream Large button uses this public path for the current image; untrusted external artifact URLs still require PLATPHORM_API_KEY.

GET /api/v1/charsets

List the active character sets used by the UI, API, and MCP tools.

GET /api/health

Health check endpoint.

curl https://ascii.platphormnews.com/api/health

GET /api/docs

OpenAPI 3.1 specification (JSON).

POST /api/mcp

Model Context Protocol endpoint. JSON-RPC style tool calls.

curl -X POST https://ascii.platphormnews.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": { "name": "get_info" }
  }'