REST API · v1<br>Vectorise.Me Developer API<br>Quality-first image vectorization over simple REST. Convert raster images to SVG, then export to PDF, EPS, DXF, PNG, JPG, WEBP, or AVIF — from your app, pipeline, or AI agent.<br>Get an API keyOpenAPI specPricing
Quickstart<br>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.<br>cURLPythonNode.js
# 1. Vectorize an image to SVG (preset picks the right settings)<br>curl -X POST https://vectorise.me/api/v1/convert \<br>-H "X-API-Key: $VECTORISE_API_KEY" \<br>-F imageFile=@logo.png \<br>-F preset=logo \<br>-F edge_recovery=auto
# Response: { "svg": "", "colorPalette": [...], ... }
# 2. Export the SVG to PDF (optional)<br>curl -X POST https://vectorise.me/api/v1/export \<br>-H "X-API-Key: $VECTORISE_API_KEY" \<br>-H "Content-Type: application/json" \<br>-d '{ "svg": "", "format": "pdf" }'<br>Scenario presets<br>One preset field tunes the trace for your image type — the same profiles the web app uses. Web, REST, and MCP share the exact same engine and settings, so results match what you see at vectorise.me. Every preset runs with no hidden AI steps: recovery is only applied when you explicitly request it.<br>PresetBest forautoEngine detects the image type and picks the best settings (default)logoLogos, icons, and text — sharp edges, exact brand colours, minimal pathsillustrationDrawings, cartoons, and clipart — smooth curves and clean colour regionsphotoPhotographs — rich tonal gradients and smooth colour transitionspixel_artPixel art and retro graphics — pixel-faithful tracing with exact colourstechnical_drawingBlueprints, schematics, and line art — sharp black & white tracing
Recovery runs on the server<br>Web, REST, and MCP callers use the same new engine. Set edge_recovery=off or real_esrgan, plus preprocess_sharpen=true|false and recovery_detail=low|med|high|ultra. Your client needs no WebGPU, local GPU, ONNX runtime, or model download. The server keeps one shared model, serializes heavy work on 2 GB hosts, caps working resolution under memory pressure, and falls back to the same direct VTracer profile if restoration cannot run. Check qualityDiagnostics.edgeRecoveryResolved to see what actually ran.
Endpoints<br>POST<br>/api/v1/convert
Vectorize a single image to SVG with the server engine. multipart/form-data with imageFile (JPG, PNG, BMP, WEBP, AVIF — up to 15 MB) plus optional preset, quality_tier, color_mode, palette controls, and output options. Recovery is OFF unless explicitly requested (edge_recovery=real_esrgan for 2× AI restore, pixel_exact for pixel-art grid recovery). Browser-only AI features are not exposed to API callers.
POST<br>/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<br>/api/v1/export
Export SVG to SVG, PDF, EPS, DXF, PNG, JPG, WEBP, or AVIF. Supports colour-layer/path grouping, SVG 1.0/1.1/Tiny 1.2, fixed dimensions, clipping, non-scaling strokes, gap cleanup, and 1–8× raster scale. Unsupported server formats are reported by /capabilities.
POST<br>/api/v1/batch
Export up to 20 SVGs in one call and receive a single ZIP. JSON body { items: [{ svg, format, ... }] }. Pro required.
GET<br>/api/v1/usage
Plan, credit balance, and 30-day usage history for the calling API key.
GET<br>/api/v1/capabilities
Available export formats and the per-format option matrix. No auth required.
GET<br>/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.
Full parameter reference<br>Everything the web app can do — presets, quality tiers, colour and palette control, and all export formats — is available over REST and MCP. The full machine-readable spec lives at /api/v1/openapi.json. Browser-only AI features are deliberately not part of the API.<br>POST /api/v1/convert<br>ParameterValuesNotesimageFilefileRequired. JPG, PNG, BMP, WEBP, or AVIF up to 15 MB.presetauto | logo | illustration | photo | pixel_art | technical_drawingScenario profile; auto detects the image type. Default auto.quality_tierfast | balanced_crisp | high_precisionSpeed/quality trade-off....