Docs
Quality-First

Complete Guide to Vectorization Options

Welcome to the official documentation for Vectorise.Me. This guide provides a comprehensive overview of every setting and feature available in our tool. Use it to unlock the full potential of your image-to-vector conversions and achieve professional-quality results.
Quick Reference

Feature & API reference

A comprehensive reference for all Vectorise.Me features, quality presets, export formats, and API endpoints. Pro features are marked.

Vectorise.Me Studio
  • Click "Studio" after any conversion — one full-page workspace to edit AND animate in Vectorise.Me Studio
  • Design mood: recolour layers, draw with pen and shape tools, edit path nodes, simplify traces
  • Layers are grouped by colour automatically — merge, hide, or restyle them from the bubble map
  • Animate mood: stack presets per layer (Float, Bounce, Pulse, Spin, Reveal…) on a drag timeline
  • Add handwritten text that draws itself on — real vector letters, self-contained in the SVG
  • Export SVG, PDF, EPS, DXF, PNG, JPG, WebP, AVIF, GIF, MP4/WebM, HTML, or React code (Pro)
Getting Started
  • Upload JPG, PNG, BMP, WEBP, or AVIF — up to 15 MB per image
  • Drag and drop or click to browse — no account required for single-file use
  • Large images are automatically optimised before conversion
  • Results appear in seconds — download as SVG instantly
  • Try it free at vectorise.me — no sign-up, no watermark
Vector Conversion
  • Detail mode follows fine source edges; Regions mode builds connected color areas
  • Up to 64 traced colors with spline curves and cutout layers
  • Dense output receives conservative same-fill compaction for easier editing
  • Palette metadata is read-only; editor changes remain explicit and reversible
  • Legacy quality fields remain accepted by the API but do not rewrite the SVG
Recovery Engine
  • Smart — uses bounded server recovery and keeps the result only when it improves quality
  • Restore — optional bounded CPU Real-ESRGAN recovery before tracing
  • Segmentation assist — optional server-safe region stabilization for API/MCP callers
  • Runs on the Vectorise.Me server for web, REST, and MCP users; no local GPU or model download
  • Low-memory servers serialize recovery jobs and cap working resolution automatically
  • If restoration is unavailable, conversion continues with the direct trace and reports the fallback in qualityDiagnostics
Colour Controls
  • Automatic palette detection from the source image
  • Similar colours are grouped into individually editable layers
  • Click any colour group to recolour, hide, or isolate it
  • Merge related colour groups into a single unified layer
  • Re-order colours by dominance, hue, or brightness
Export Formats
  • SVG — infinitely scalable vector, always included free
  • PDF — print-ready output for professional workflows
  • PNG / JPG / WEBP / AVIF — raster re-export at 1–8×, capped at 32 MP
  • SVG 1.0 / 1.1 / Tiny 1.2, color layers or individual paths, fixed or responsive dimensions
  • EPS — industry standard for print and press (Pro)
  • DXF — CAD-compatible for laser cutters and CNC machines (Pro)
Pro Plan — $5.99/mo or $59.99/yr
Pro
  • Process up to 20 images at once with batch mode
  • Download all results as a single ZIP archive
  • EPS and DXF export formats unlocked
  • Apply the same settings across your entire queue in one click
  • Priority processing — your jobs are always served first
  • 500 API credits included every month
  • REST API access with your own API key
  • No ads · Cancel anytime · No lock-in
API — Authentication & Rate Limits
Pro
  • Auth: X-API-Key: vm_live_xxx header — generate your key in the signed-in dashboard
  • Keys belong to your signed-in account email, so credits and usage stay trackable
  • Or use Authorization: Bearer <jwt> for signed-in web users
  • Anonymous: 5 requests/min · Free account: 20/min
  • Pro web user: 100 requests/min · API key: 200 requests/min
  • All requests must be made over HTTPS
  • 402 returned when credit balance is zero — sign in and top up from /pricing
API — POST /convert
Pro
  • POST /convert (multipart/form-data)
  • imageFile — the image to convert (required)
  • The trace profile is fixed to direct_standalone for deterministic parity
  • edge_recovery — real_esrgan (optional 2× AI restore; executes server-side)
  • recovery_detail — low | med | high | ultra (server caps safely on low-memory hosts)
  • Legacy quality/profile/palette fields are accepted but do not alter the direct trace
  • Returns: { svg, colorGroups, colorPalette, qualityDiagnostics, traceStats, ... }
API — Other Endpoints
Pro
  • POST /export-svg — export SVG to SVG, PDF, PNG, JPG, WEBP, AVIF, EPS, or DXF
  • GET /export-capabilities — list available formats and server features
  • GET /api/agent/usage — check credit balance with X-API-Key
  • POST /api/stripe/create-checkout — start a Pro subscription or credit pack purchase
  • POST /api/stripe/portal — open the Stripe customer billing portal
  • POST /api/keys — generate an API key for the signed-in user
  • GET /api/keys — list your active API keys
  • DELETE /api/keys/:id — revoke an API key
  • GET /api/usage — credit balance and daily usage statistics
API Credit Packs
Pro
  • $5.99 → 500 credits ($0.012 each)
  • $14.99 → 1,500 credits ($0.010 each)
  • $29.99 → 4,000 credits ($0.0075 each) — best value
  • Buy from /pricing with card after signing in
  • Create API keys in /app after signing in
  • Pay by card with Stripe checkout
  • Credits never expire · 1 credit = 1 /convert API call · track balance in /app → Usage
  • Error 402 when balance is zero — top up anytime, no subscription required
Agent API

Registered API setup

Sign in with an email link, buy Pro or credit packs, then create an API key in /app. Keys are tied to your account email so usage and balance stay trackable.

1) Create a key in the dashboard
# In /app, open API Keys, create a key, then add it to your agent:
VECTORISE_API_KEY=vm_live_...
VECTORISE_API_URL=https://vectorise.me
Buy credit packs from /pricing. The balance is stored on the signed-in account that owns the key.
2) Use the API key
curl -X POST https://YOUR_DOMAIN/convert \
  -H "X-API-Key: vm_live_..." \
  -F imageFile=@image.png
3) Check credits
curl https://YOUR_DOMAIN/api/agent/usage \
  -H "X-API-Key: vm_live_..."

Overview

Welcome to the official documentation for Vectorise.Me. This guide provides a comprehensive overview of every setting and feature available in our tool. Use it to unlock the full potential of your image-to-vector conversions and achieve professional-quality results.

Table of Contents

  • The Converter Interface

  • Quick Start Presets

  • Main Controls

  • Recovery Engine

  • Advanced Options

The Converter Interface

After uploading an image, you are presented with the main converter interface. It is divided into three key areas: the Quick Start Presets at the top, the detailed Options Panel on the left, and the interactive Preview Panel on the right.

Quick Start Presets

This is the fastest way to get great results. The presets are expertly-tuned collections of settings optimized for common image types. Simply click a card that matches your image (e.g., 'Clipart / Logo'), then select a detail level ('Low', 'Medium', 'High', 'Max'). This instantly configures all advanced options for you. You can then fine-tune them further if needed.

Main Controls

These are the most impactful settings for your conversion, located at the top of the Options Panel for easy access.

Color Mode

This fundamental choice determines the color space of your final vector. Color: Creates a full-color SVG that matches the source image's colors. Black & White: Converts the image to a two-tone (binary) output, ideal for simple silhouettes or stencils.

Color Detail

This powerful setting controls the number of unique colors in the final SVG (from 2 to 128). Reducing the color count is the most effective way to simplify an image and reduce file size. Our system intelligently analyzes your image to create an optimal color palette for the number you choose.

Mode

Determines the fundamental shape-fitting algorithm used to create the vector paths. Spline: Creates smooth, curved paths. This is the best choice for most images, including illustrations and photographs, as it produces natural-looking, organic shapes. Polygon: Creates paths with sharp, straight-line corners. Excellent for geometric designs or when a stylized, low-poly look is desired. Pixel: A special mode for pixel art. It converts each pixel into a perfectly aligned square vector shape, creating an infinitely scalable and clean version of the original.

Filter Speckle

This is a cleanup tool that removes small, unwanted spots or "speckles" of color from the image. The value represents the size in pixels of the speckles to remove. This is extremely useful for cleaning up noisy source images and can significantly reduce file size by ignoring irrelevant details.

Recovery Engine

The current Pixel Exact + Real-ESRGAN + VTracer pipeline is shared by the web app, REST API, and MCP tools. Recovery runs on the Vectorise.Me server, so users do not need WebGPU, a local GPU, ONNX Runtime, or a model download.

  • Smart: checks for pixel art first, then restores ordinary photos, logos, illustrations, and blurry inputs.

  • Restore: requests bounded CPU Real-ESRGAN reconstruction before tracing.

  • Pixel Exact: recovers a detected source grid as clean coloured vector rectangles.

Advanced Options

For maximum control, expand the 'Advanced Options' section. These settings allow you to fine-tune the tracing engine's behavior.

Path Precision

Controls how closely the vector paths follow the original image's contours. Higher values result in more detail and accuracy but can lead to larger file sizes. Lower values produce simpler, more generalized paths.

Pro Access

Unlock batch & API access

Pro at $5.99/mo gives you 500 API credits/month plus advanced web controls, EPS, DXF, and batch ZIP downloads. Credit packs start at $0.0075/image with no subscription required; card and crypto options are shown on the pricing page.

Vectorise.Me Documentation