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.

Animate SVG (New)
  • Click "Animate SVG" next to the editor after any conversion
  • Layers are grouped by colour automatically — rename, merge, hide, or delete them
  • Stack presets per layer: Float, Bounce, Pulse, Spin, Swing, Reveal, and more
  • Tune speed, strength, delay/stagger, direction, and easing with simple sliders
  • "Animate All" gives every layer a staggered motion in one click
  • Export endless loops as animated SVG, GIF, MP4/WebM, HTML page, or React code (Pro)
Getting Started
  • Upload JPG, PNG, BMP, WEBP, or AVIF — up to 25 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
Quality Presets
  • Everyday — balanced general-purpose output for mixed images
  • Illustration — smooth Bézier curves ideal for drawings and artwork
  • Photo — rich tonal gradients for photographic subjects
  • Logo — minimal clean paths, perfect for icons and branding
  • Pixel — sharp pixel-perfect edges for pixel art and retro graphics
  • Auto — the engine selects the best preset based on image analysis
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 — raster re-export at any resolution
  • 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)
  • quality_profile — everyday | illustration | photo | logo | pixel | exact | auto
  • quality_tier — fast | balanced_crisp | high_precision (default: balanced_crisp)
  • exact mode — set quality_profile=exact with quality_tier=high_precision for pixel-faithful tracing with exact colors
  • palette_count — integer 4–128, colours to extract (default: auto)
  • color_mode — color | grayscale | outline | bw (default: color)
  • Returns: { svg, colorGroups, colorPalette, qualityDiagnostics, traceStats, ... }
API — Other Endpoints
Pro
  • POST /export-svg — convert SVG to PDF, PNG, JPG, WEBP, 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

  • Advanced Options

  • The Preview Panel

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.

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.

Corner Threshold

Determines how "sharp" a corner must be (in degrees) before the tracer creates a hard-angled point instead of a smooth curve. A high value (e.g., 100°) is great for logos and technical drawings. A lower value will create smoother, more rounded corners.

Pro Access

Unlock batch & API access

Pro at $5.99/mo gives you 500 API credits/month plus unlimited web conversions, EPS, DXF, and batch ZIP downloads. Pay by card only. From $0.0075/image on credit packs — no subscription required.