REST API · v1

Vectorise.Me Developer API

Quality-first image vectorization over simple REST. Convert raster images to SVG, then export to PDF, EPS, DXF, PNG, JPG, or WEBP — from your app, pipeline, or AI agent.

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

# 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" }'

Presets — one word instead of ten knobs

Every vectorization option in the app is available through the API, but for most images you only need preset. It expands into the right engine settings (quality_profile, colour handling, exact-colour preservation) — and any field you set explicitly alongside it always wins. The same presets work in the MCP tools.

Preset	Best for
auto	Engine detects the image type and picks the best settings (default)
logo	Logos, icons, and text — sharp edges, exact brand colours, minimal paths
illustration	Drawings, cartoons, and clipart — smooth curves and clean colour regions
photo	Photographs — rich tonal gradients and smooth colour transitions
pixel_art	Pixel art and retro graphics — pixel-faithful tracing with exact colours
technical_drawing	Blueprints, schematics, and line art — sharp black & white tracing

Endpoints

POST

/api/v1/convert

Vectorize a single image to SVG. multipart/form-data with imageFile (JPG, PNG, BMP, WEBP, AVIF — up to 25 MB). Set preset for a one-word configuration, or fine-tune with quality_tier, quality_profile, color_mode, details_level, paletteCount, fixed_palette and more. Returns SVG markup, colour palette, and quality diagnostics as JSON.

POST

/api/v1/convert-batch

Vectorize up to 10 images in one request. Repeated imageFiles form entries plus shared settings (preset, quality_tier, ...) applied to every image. Each file gets an independent result — one bad image does not fail the batch. Credits are charged per successful conversion.

POST

/api/v1/export

Convert an SVG to another format: PDF, EPS, DXF, PNG, JPG, or WEBP. JSON body { svg, format, exportOptions? }. EPS and DXF require a Pro plan. Returns download handles for /download-file.

POST

/api/v1/batch

Export up to 20 SVGs in one call and receive a single ZIP. JSON body { items: [{ svg, format, ... }] }. Pro required.

GET

/api/v1/usage

Plan, credit balance, and 30-day usage history for the calling API key.

GET

/api/v1/capabilities

Available export formats and the per-format option matrix. No auth required.

GET

/api/v1/status

API health check. Queue depths available at /health. No auth required.

Credits & pricing

Pay per conversion, no subscription required. Credits per call by quality tier: fast = 1, balanced_crisp = 2, high_precision = 5.

Credit packs: $5.99 / 500 · $14.99 / 1,500 · $29.99 / 4,000 (from $0.0075 per image). Pro subscribers get 500 credits/month included.

Rate limits

API keys: 200 requests/min with a per-key cap on concurrent conversions. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset; 429/503/504 responses include Retry-After.

Built for AI agents

Stable JSON schemas, predictable error codes, and a machine-readable OpenAPI 3.1 spec. Point your agent at GET /api/v1 for a self-describing capabilities document.

Use from Claude, Cursor & AI agents (MCP)

The official vectorise-mcp package 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 — all with the same friendly presets.

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

Error codes

Code	HTTP	Meaning
RATE_LIMITED	429	Request rate exceeded — respect the Retry-After header.
API_KEY_BUSY	429	Too many concurrent conversions in flight for this key.
QUEUE_FULL	429	Conversion queue is full for the requested quality tier.
INSUFFICIENT_CREDITS	402	API credit balance is empty — top up at /pricing.
STORAGE_FULL	507	Server storage temporarily full — retry after the suggested delay.
AT_CAPACITY	503	Server at capacity for the requested tier — retry shortly.
QUEUE_TIMEOUT	504	Timed out waiting for a conversion slot — retry shortly.

Start converting in under a minute

Create a key, send an image, get an SVG back. First conversions cost pennies.

Get your API key