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.

Getting Started
  • Upload JPG, PNG, BMP, or WEBP — 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 — $9/mo or $79/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
  • 1,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 Pro dashboard
  • 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 — top up via dashboard or crypto
API — POST /convert
Pro
  • POST /convert (multipart/form-data)
  • imageFile — the image to convert (required)
  • quality_profile — everyday | illustration | photo | logo | pixel | auto
  • quality_tier — fast | balanced_crisp | high_precision (default: balanced_crisp)
  • palette_count — integer 4–128, colours to extract (default: auto)
  • color_mode — color | bw (default: color)
  • engine — auto | potrace_bw (default: auto)
  • 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
  • POST /api/agent/checkout — buy credits + get API key (no sign-up)
  • 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 (Pro only)
  • 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
  • POST /api/crypto/create-charge — pay with USDC stablecoin, returns { hosted_url }
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
  • Agents can buy credits via /api/agent/checkout with crypto wallet
  • Pay by card (Stripe) or USDC stablecoin (optional crypto checkout)
  • Agentic payment: POST /api/crypto/create-charge → { hosted_url } — optional for AI agents
  • Credits never expire · 1 credit = 1 /convert API call
  • Error 402 when balance is zero — top up anytime, no subscription required
Agent API

No-signup API setup (credits-only)

Create a key and buy credits in one request, then call /convert with X-API-Key. No account required. Agents can pay via crypto wallet by using method=crypto.

1) Create key + checkout
curl -X POST https://YOUR_DOMAIN/api/agent/checkout \
  -H "Content-Type: application/json" \
  -d '{"pack":"1500","method":"stripe"}'
For agents paying with crypto: set method to crypto.
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 $9/mo gives you 1,500 API credits/month plus unlimited web conversions, EPS, DXF, and batch ZIP downloads. Pay by card or USDC crypto. From $0.0075/image on credit packs — no subscription required.