Vectorise.Me Developer API

Quickstart

Sign in at vectorise.me, open the dashboard and create a key in the API Keys panel, then send an image. Keys use a single X-API-Key header — no OAuth, no token refresh.

# 1. Vectorize an image to SVG (preset picks the right settings)
curl -X POST https://vectorise.me/api/v1/convert \
  -H "X-API-Key: $VECTORISE_API_KEY" \
  -F imageFile=@logo.png \
  -F preset=logo \
  -F edge_recovery=auto

# Response: { "svg": "<svg ...>", "colorPalette": [...], ... }

# 2. Export the SVG to PDF (optional)
curl -X POST https://vectorise.me/api/v1/export \
  -H "X-API-Key: $VECTORISE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "svg": "<svg ...>", "format": "pdf" }'

Scenario presets

One preset field tunes the trace for your image type — the same profiles the web app uses. Web, REST, and MCP share the exact same engine and settings, so results match what you see at vectorise.me. Every preset runs with no hidden AI steps: recovery is only applied when you explicitly request it.

Endpoints

Full parameter reference

Everything the web app can do — presets, quality tiers, colour and palette control, and all export formats — is available over REST and MCP. The full machine-readable spec lives at /api/v1/openapi.json. Browser-only AI features are deliberately not part of the API.

Use from Claude, Cursor & AI agents (MCP)

The official vectorizer-mcp package (also published as vectorise-mcp — identical, either name works) exposes vectorization as tools for any MCP-compatible client. Once configured, just ask your assistant to "vectorize logo.png as an SVG" — it handles upload, conversion, and saving the result. Tools: vectorize_image, vectorize_batch (up to 20 files), export_svg, get_usage, get_capabilities, and get_status — all with the same scenario presets and export settings as the REST API. Optional server-side recovery runs on Vectorise.Me infrastructure, never inside Claude or Cursor, and only when explicitly requested.

// claude_desktop_config.json
{
  "mcpServers": {
    "vectorizer": {
      "command": "npx",
      "args": ["-y", "vectorizer-mcp"],
      "env": { "VECTORISE_API_KEY": "vm_live_..." }
    }
  }
}

Error codes