Docs
Quality-First

Complete Guide to Vectorise.Me

Everything you need to turn an image into a clean vector: choosing an engine, the options, the palette, downloads and Studio.
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, WEBP or AVIF (up to 15 MB) — it converts straight away, no sign-up, no watermark
  • Very large images: choose to scale down or crop (Basic up to 1.5 MP, Pro up to 4 MP)
  • The result opens fitted to your screen: compare it with the original side by side or with the slider
  • Change any setting and press Re-run — the original upload is kept, nothing is re-uploaded
  • Download SVG free; Studio opens the result for editing and animation
Engines — Clean, Detail, Regions
  • Clean (default): smooth, tidy shapes in exactly your image's own colours, neighbouring colours sharing one edge — logos, cartoons, flat art, stickers
  • Detail: traces every pixel at full resolution — small text, thin lines, detailed illustrations and photos
  • Regions: every colour area becomes one solid, gap-free piece, the fewest shapes — icons, simple logos, screen printing
  • Every engine is free, and every result's colours are checked against your image and corrected if they drifted
  • Clean hands over to Detail by itself for images with see-through colours, so nothing fails
Options
  • Speed — Fast (fewest shades, simplest curves, smallest file) · Balanced · Detailed (most shades, tightest curves). Detailed is Pro; Basic includes 2 free Detailed conversions a day
  • Colour — Colour, Grey, Black & White (one colour, for stencils) or Outline (lines only, for engraving)
  • Remove background — the plain background around your artwork becomes transparent; white inside it (eyes, highlights) stays
  • Cut-ready layers — no shape overlaps another, so each colour is one piece for Cricut, vinyl, screen printing and lasers (Regions always is)
  • Enhance before tracing (Pro) — Restore cleans blur and JPEG compression; 2× upscale helps small images and thin lines. Both run on your own GPU
Palette
  • Every colour in your vector as a bubble, sized by how much of the image it covers — click one to highlight it on the image
  • Pro: drag a bubble onto another to merge those colours, drag it out to split, and recolour any colour
  • Pro: Merge similar colours from Keep all to Poster in one click, or fine-tune the merge strength
  • Your download uses the merged colours; Reset brings the original palette back
Export Formats
  • SVG — editable vector for Cricut, Illustrator, Figma and websites (free)
  • PDF — vector PDF for print · PNG / JPG / WEBP / AVIF — images at 1×, 2×, 4× or 8× (up to 32 MP) with Best, Balanced or Smaller-file quality
  • EPS — print shops and older design software (Pro) · DXF — CAD, laser cutters and CNC (Pro)
  • Vector options (Pro): one layer per colour, keep pixel size, clip to artboard, line width and non-scaling lines for Outline results, SVG 1.1 / 1.0 / Tiny 1.2
  • Pro: download several files at once or everything as one ZIP
Vectorise.Me Studio
  • Click "Studio" after any conversion — your artwork opens fitted to the screen, ready to edit and animate
  • Select a colour (click the artwork or a bubble) for the task bar: recolour, glow, shadow, hide, and one-click motion (Float, Pulse, Bounce, Spin…)
  • Draw with pen and shape tools, edit nodes, Unite / Subtract / Divide shapes, simplify traces, add self-drawing handwritten text
  • Animate mood: stack motion presets per layer on a drag timeline; the timeline folds away while you design
  • Start from a blank canvas (Square, A4, social post, story, HD) or open any SVG
  • Export SVG, PDF, EPS, DXF, PNG, JPG, WebP, AVIF, GIF, MP4/WebM, HTML or React code (Pro)
Pro Plan — $5.99/mo or $59.99/yr
Pro
  • Unlimited Detailed speed, plus Restore and 2× upscale
  • Images up to 4 MP, batch of up to 20 images, download all as ZIP
  • EPS and DXF, vector export options, full Palette editing and the SVG code editor
  • Studio exports, priority processing and no ads
  • 500 API credits every month · REST API with your own key · Cancel anytime
API — Authentication & Rate Limits
Pro
  • Auth: X-API-Key: vm_live_xxx header — generate your key in the signed-in dashboard
  • Or use Authorization: Bearer <jwt> for signed-in web users
  • Anonymous: 5 requests/min · Free account: 20/min · Pro web user: 100/min · API key: 200/min
  • 402 returned when credit balance is zero — top up from /pricing
  • Spec: /api/v1/openapi.json · Index: /api/v1 · MCP server: npx vectorizer-mcp
API — POST /api/v1/convert
Pro
  • multipart/form-data with imageFile (required)
  • engine — trace (Clean) | direct (Detail) | planar (Regions) | fast. Omitted: Clean at Balanced
  • speed — fast | balanced | detailed · layers — stacked | cutout · remove_background — true
  • color_mode — color | grayscale | bw | outline · preset — auto | logo | illustration | photo | pixel_art | technical_drawing
  • Older fields (optimize_for, shape_style, quality_profile…) are still accepted, so existing integrations keep working
  • Returns { svg, colorGroups, colorPalette, qualityDiagnostics, traceStats, … }
API — Other Endpoints
Pro
  • POST /api/v1/export — SVG to SVG, PDF, PNG, JPG, WEBP, AVIF, EPS or DXF (EPS/DXF need Pro)
  • POST /api/v1/batch — up to 10 images with shared settings
  • GET /api/v1/capabilities — formats and server features · GET /api/v1/usage — credit balance
  • POST /api/keys · GET /api/keys · DELETE /api/keys/:id — manage API keys
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
  • Credits never expire · 1 credit = 1 conversion · track balance in /app → Usage
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

Everything you need to turn an image into a clean vector: choosing an engine, the options, the palette, downloads and Studio.

Table of Contents

  • The Converter

  • Choosing an Engine

  • Speed, Colour and Output

  • Enhance Before Tracing

  • The Palette

The Converter

Drop an image (JPG, PNG, BMP, WEBP or AVIF, up to 15 MB) and it converts straight away. The result opens fitted to your screen: compare it with the original side by side, or drag the slider across. The settings panel on the right is numbered in the order you would use it — Engine, Speed, Colour, Output, Enhance. Change anything and press Re-run ; your upload is kept, so nothing is sent again. Very large images ask whether to scale down or crop first (Basic up to 1.5 MP, Pro up to 4 MP).

Choosing an Engine

Every engine is free, and every result&rsquo;s colours are checked against your image and corrected if they drifted.

Images with see-through colours are traced by Detail automatically, since Clean draws solid colour only.

  • Clean (the default): smooth, tidy shapes in exactly your image&rsquo;s own colours, with neighbouring colours sharing one edge, so there are no gaps. Best for logos, cartoons, flat artwork and stickers.

  • Detail : traces every pixel at full resolution, so small text, thin lines and fine texture survive. Best for detailed illustrations and photos.

  • Regions : every colour area becomes one solid, gap-free piece — the fewest shapes of any engine. Best for icons, simple logos and screen printing.

Speed

  • Fast : the fewest shades and simplest curves; the smallest file.

  • Balanced : each engine&rsquo;s measured best all-round setting.

  • Detailed : the most shades and the tightest curves, so gradients and fine detail survive; the largest file. Detailed is a Pro speed, and Basic includes two free Detailed conversions a day.

Colour

Colour keeps full colour; Grey uses shades of grey; Black & White makes one solid colour, ideal for stencils and single-colour cuts; Outline draws lines only, for engraving and colouring pages.

Output

  • Remove background : the plain background around your artwork becomes transparent. White inside the artwork (eyes, highlights) stays.

  • Cut-ready layers : no shape overlaps another, so each colour is one piece — what Cricut, vinyl cutters, screen printing and lasers need. Regions output is always cut-ready.

Enhance Before Tracing (Pro)

Restore cleans blur and JPEG compression before tracing — useful for screenshots, old scans and soft photos. 2&times; upscale doubles small images so thin lines and small text trace cleanly. Both run on your own device&rsquo;s GPU before upload, so they are quick and private.

The Palette

The Palette tab shows every colour in your vector as a bubble, sized by how much of the image it covers. Click a bubble to highlight that colour on the image. With Pro you can drag a bubble onto another to merge those colours, drag it out to split them, recolour any colour, and merge similar shades in one click (Keep all, Light, Medium, Strong, Poster). Your download uses the merged colours, and Reset brings the original palette back.

Downloading Your Vector

Pro vector options: one layer per colour, keep pixel size (recommended for Cricut and Illustrator), clip to artboard, line width and non-scaling lines for Outline results, and SVG 1.1, 1.0 or Tiny 1.2. Pro can also download several files at once or everything as one ZIP.

  • SVG (free): the editable vector for Cricut, Illustrator, Figma and websites.

  • PDF : a vector PDF for printing and sharing.

  • PNG, JPG, WEBP, AVIF : images at 1&times;, 2&times;, 4&times; or 8&times; size (up to 32 MP) with Best, Balanced or Smaller-file quality. PNG keeps transparency.

  • EPS (Pro): for print shops and older design software. DXF (Pro): for CAD, laser cutters and CNC.

Vectorise.Me Studio

Click Studio after any conversion and your artwork opens fitted to the screen, ready to edit and animate. Select a colour (click the artwork or a bubble) and a task bar offers recolour, glow, shadow, hide and one-click motion such as Float, Pulse, Bounce and Spin. Draw with pen and shape tools, edit nodes, combine shapes (Unite, Subtract, Divide), simplify traces and add handwritten text that draws itself. Switch to Animate to time motion on the timeline. You can also start from a blank canvas (Square, A4, social post, story, HD) or open any SVG. Exporting from Studio is Pro.

Raster Image

An image made up of a grid of pixels (e.g., JPG, PNG). Raster images lose quality and become blurry when scaled up.

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