Bitmap → SVG tracing. One endpoint, multipart upload, SVG back. Machine-readable summary at /llms.txt, full parameter schema at /api/schema.
| field | type | notes |
|---|---|---|
image | file | png / jpeg / webp / bmp / tiff — max 10MB |
settings | JSON string | optional — preset, engine, per-engine params |
Optional header X-API-Key: requests run on a dedicated processing lane and are usage-tracked per key.
curl -X POST https://vectorize.erpfit.com/api/vectorize \
-F "[email protected]" \
-F 'settings={"preset":"auto"}'
curl -X POST https://vectorize.erpfit.com/api/vectorize \
-H "X-API-Key: ef_vectorize_…" \
-F "[email protected]" \
-F 'settings={"engine":"tracecraft","tracecraft":{"maxColors":32}}'
Response: {"svg", "engine", "originalSize", "svgSize"}. Errors: 400 invalid input, 401 bad API key, 429 queue full (honor Retry-After), 503 job timeout.
| preset | best for |
|---|---|
auto (default) | let the service pick engine + settings from the image |
logo | flat logos, icons, brand marks |
photo | photographs, smooth gradients |
poster | illustrations, bold flat shapes |
lineart | sketches, engravings, monochrome |
| engine | what it is |
|---|---|
auto | picks per image (flat → tracecraft, complex → vtracer, mono → potrace) |
tracecraft | in-house engine — planar shared-edge topology, render-and-refine |
tracecraft2 | primitive recognition (rect/circle/ellipse) — smallest files |
potrace2 | color potrace via tracecraft segmentation |
vtracer / potrace | classic tracers |
Per-engine parameters, ranges and defaults: GET /api/schema.
GET /api/health — status, queue lanes, workers. Jobs are processed through a bounded queue; on 429 retry after the indicated delay.