Skip to content
API + MCP + SDK + CLI

VectoSolve for Developers

AI-powered image tools you can use from Claude Code, your terminal, your Node.js app, or any HTTP client. Vectorize, remove backgrounds, upscale, and generate logos.

10 free API calls·No card. Create a key and run real conversions before you pay anything.

Works with
curl -X POST https://vectosolve.com/api/v1/vectorize \
  -H "Authorization: Bearer vs_xxx" \
  -F "file=@logo.png"

# {
#   "success": true,
#   "data": { "svg": "<svg ...>", "svg_url": "...", "format": "svg",
#             "source_quality": { "level": "green", ... } },
#   "credits": { "used": 0.2, "remaining": 9.8 }
# }
Input: a small PNG logo
logo.png
Output: the same logo as a clean SVG
data.svg

Pick your integration

Same key, same credits, same output across all four.

MCP

Hosted MCP server

One HTTPS URL for Claude Code, Cursor, VS Code and Windsurf, with your API key. Your agent vectorizes images and exports SVG, DXF, G-code, DST, PES, JEF, EPS, AI, PDF or PNG.

claude mcp add --transport http vectosolve https://vectosolve.com/api/v1/mcp --header "Authorization: Bearer vs_xxx"
Setup for every client, tools and formats
Full example
// Hosted server: https://vectosolve.com/api/v1/mcp
// Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "vectosolve": {
      "url": "https://vectosolve.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer vs_xxx" }
    }
  }
}

// Tools: vectorize (modes standard | laser | cricut | embroidery | centerline,
//        formats svg | dxf | eps | ai | pdf | png | gcode | dst | pes | jef),
//        export_svg, remove_background, upscale, generate_logo, get_credits

// Local alternative (stdio): claude_desktop_config.json
{
  "mcpServers": {
    "vectosolve": {
      "command": "npx",
      "args": ["@vectosolve/mcp"],
      "env": {
        "VECTOSOLVE_API_KEY": "vs_xxx"
      }
    }
  }
}

// Local package tools
// vectorize          Convert image to SVG        0.20 credits/call
// remove_background  Remove image background     $0.07/call
// upscale            Upscale image resolution    $0.15/call
// generate_logo      Generate SVG logo from text $0.40/call
SDK

npm SDK

TypeScript-first SDK with full type safety. Works in Node.js 18+.

npm install @vectosolve/sdk
Full example
import { VectoSolve } from '@vectosolve/sdk'

const vs = new VectoSolve({ apiKey: 'vs_xxx' })

// Vectorize an image
const result = await vs.vectorize({ file: './logo.png' })
console.log(result.data.svg)  // <svg>...</svg>

// Or from URL
const result2 = await vs.vectorize({ imageUrl: 'https://example.com/logo.png' })

// Remove background
const bg = await vs.removeBg({ file: './photo.jpg' })
console.log(bg.data.image_url)

// Upscale
const up = await vs.upscale({ file: './image.png' })

// Generate logo
const logo = await vs.generateLogo({
  prompt: 'minimalist tech startup logo',
  style: 'vector_illustration',
  colors: ['#1cb721', '#0090ff'],
})
console.log(logo.data.logos[0].svg)

// Batch process
const batch = await vs.batch([
  { url: 'https://example.com/img1.png', operation: 'vectorize' },
  { url: 'https://example.com/img2.png', operation: 'remove_bg' },
])
CLI

Command Line

Vectorize images directly from your terminal. Pipe into other tools.

npx vectosolve convert logo.png
Full example
# Install globally
npm install -g vectosolve

# Authenticate
vectosolve auth --key vs_xxx

# Convert image to SVG
vectosolve convert logo.png
vectosolve convert logo.png -o output.svg

# From URL
vectosolve convert https://example.com/logo.png --url

# Remove background
vectosolve remove-bg photo.jpg -o clean.png

# Upscale
vectosolve upscale image.png -o upscaled.png

# Generate logo
vectosolve logo "minimalist tech startup" --style vector_illustration
vectosolve logo "coffee shop emblem" -n 4 -c "#8B4513,#F5DEB3"

# Or use npx (no install)
npx vectosolve convert logo.png
REST

REST API

Direct HTTP calls from any language. The OpenAPI spec imports into Postman, Insomnia or your codegen.

curl -X POST https://vectosolve.com/api/v1/vectorize -H "Authorization: Bearer vs_xxx" -F "file=@logo.png"
Full example
# Vectorize
curl -X POST https://vectosolve.com/api/v1/vectorize \
  -H "Authorization: Bearer vs_xxx" \
  -F "file=@logo.png"

# Or with URL
curl -X POST https://vectosolve.com/api/v1/vectorize \
  -H "Authorization: Bearer vs_xxx" \
  -F "image_url=https://example.com/logo.png"

# Full param set: exact 4-color cap, DXF for laser, snapped to your stock palette
curl -X POST https://vectosolve.com/api/v1/vectorize \
  -H "Authorization: Bearer vs_xxx" \
  -F "file=@artwork.png" \
  -F "mode=laser" \
  -F "output_format=dxf" \
  -F "colors=4" \
  -F "palette=#000000,#ff0000,#00ff00,#0000ff" \
  -F "dxf_version=AC1015" \
  -F "units=mm" \
  -F "cam_preset=lightburn" \
  -F "target_width=300"

# Planar / 3D mode: non-overlapping flush tiles — extrude straight to 3D, no z-fighting
curl -X POST https://vectosolve.com/api/v1/vectorize \
  -H "Authorization: Bearer vs_xxx" \
  -F "file=@artwork.png" \
  -F "colors=4" \
  -F "planar=true"

# Remove background
curl -X POST https://vectosolve.com/api/v1/remove-bg \
  -H "Authorization: Bearer vs_xxx" \
  -F "file=@photo.jpg"

# Generate logo
curl -X POST https://vectosolve.com/api/v1/generate-logo \
  -H "Authorization: Bearer vs_xxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "minimalist tech logo", "style": "vector_illustration"}'

Buy API conversions

Prepaid credits, no subscription. Credits never expire, so they fit usage that starts small and grows.

$19.99
100 conversions
$0.200 each
$79
500 conversions
$0.158 each
$259
2,000 conversions
$0.130 each

Using this every month? A yearly plan works out cheaper per conversion, and unused conversions roll over instead of expiring — see the plans.

Need more than that, or a different shape? Email support@vectosolve.com with your monthly volume and we'll size it with you.

API Endpoints

Click an endpoint for its parameters and response.

POST/api/v1/vectorize0.20 credits
Parameters
file: image file (multipart/form-data)
image_url: public URL (alternative to file)
mode: standard | laser | cricut | embroidery | centerline (optional, default standard). centerline traces ONE curve down the middle of each stroke (local skeletonisation, no color post-processing) for line art, plans and V-carving; the other modes trace outlines, so a thick stroke returns as two parallel edges. Not available on /v1/batch
output_format: svg | dxf (optional; dxf adds inline DXF, tuned via dxf_version, units, cam_preset, target_width)
colors: integer 0-64 (optional, default 0=auto). Hard cap on the exact number of colors in the output, merged perceptually in OKLab — set colors=4 for a clean 4-color separation
palette: comma-separated hex list e.g. "#000000,#ff0000" (optional). Snaps every output color to the nearest color in your stock/thread palette
planar: true (optional). Flattens stacked shapes into flush, NON-OVERLAPPING tiles — no z-fighting when you extrude to 3D or layer materials. Curves become dense polylines (mesh-ready geometry). Expect roughly 10-15x the file size on dense palettes: measured 13.7x on a 6-colour input. If a boolean step fails on a path, the response carries planar_warnings instead of silently leaving it uncut
Response
{ success, data: { svg, dxf?, svg_url, format, mode, processing_time_ms, source_quality: { level: green|amber|red, source_width, source_height, upscaled, thinnest_line_px?, smallest_lettering_px?, review_recommended, note } }, credits: { used, remaining } }
POST/api/v1/remove-bg$0.07
Parameters
file: image file (multipart/form-data)
image_url: public URL (alternative to file)
Response
{ success, data: { image_url, format, processing_time_ms }, credits: { used, remaining } }
POST/api/v1/upscale$0.15
Parameters
file: image file (multipart/form-data)
image_url: public URL (alternative to file)
Response
{ success, data: { image_url, format, processing_time_ms }, credits: { used, remaining } }
POST/api/v1/generate-logo$0.25–$0.40
Parameters
prompt: text description (required, min 3 chars)
style: vector_illustration | line_art | icon | ... (default: vector_illustration)
model: v3 | v2 (default: v3)
colors: ["#hex1", "#hex2"] (optional, max 5)
num_variants: 1 | 2 | 4 (default: 1)
Response
{ success, data: { logos: [{ svg_url, svg }], processing_time_ms }, credits: { used, remaining } }
POST/api/v1/batchvaries
Parameters
images: [{ url, operation, mode? }] (max 25)
operation: vectorize | remove_bg | upscale
mode: top-level default for vectorize items (optional)
async: true = fire-and-forget — returns 202 { job_id, status_url }, poll GET /api/v1/jobs/{job_id} (optional)
webhook_url: HTTPS completion webhook, async mode only (optional)
Response
{ success, data: { results: [{ index, success, url, svg?, error, operation, source_quality? }], total_processed, total_failed }, credits } — failed items auto-refunded; source_quality (vectorize items) carries the per-file review verdict, same shape as /v1/vectorize
POST/api/v1/export$0.10–$0.25
Parameters
svg_content: SVG document as a string (max 10MB, must contain <path> geometry)
format: gcode | eps | ai | dxf | pdf | png | dst | pes | jef
options: per-format options object (optional, strictly validated — see GET /api/v1/export or /openapi.json)
Response
{ success, data: { format, content | content_base64, content_type, processing_time_ms }, credits } — billed per export on the API (web-app free exports do not apply here)

Authentication

All endpoints require a Bearer token:

Authorization: Bearer vs_xxx

Rate limit

60 requests/minute. Headers: X-RateLimit-Remaining, Retry-After

OpenAPI spec

openapi.json — import it into Postman, Insomnia, or your codegen of choice.

Per-Operation Costs

Same credits across API, MCP, SDK, and CLI.

Vectorize
0.20 credits
Remove BG
$0.07
Upscale
$0.15
Logo Gen
$0.25–$0.40

API access

The REST API, MCP server, SDK and CLI are included in the production plans. Same key, same output, no separate API bill.

Evaluating first? Your first 10 API calls are free, on vectorize, background removal and upscale. No card, no plan — create a key and run them today.

For production shops

If you are converting customer artwork at volume, the plan you want is on the shop page: batch upload, every export format, and the API in the same subscription.

See the production plans

Building something else on top of the API? Tell us what you need and we will quote it.

Built For

AI Agents

Claude Code, Cursor, and other AI tools via MCP

E-commerce

Auto-vectorize product images for scalable graphics

Design Tools

Add vectorization to your design app or plugin

Craft Platforms

Let users convert images to cut-ready SVGs

Start Building Today

Create an API key and start building. Works with Claude Code, npm, CLI, and REST.

Get API Key

Questions? Email us at support@vectosolve.com