Come automatizzare la conversione da immagine a SVG: API, SDK e elaborazione batch

Manual image-to-SVG conversion works when you have a few files. But when you are dealing with a product catalog of 500 images, a design system with 200 icons, or a daily feed of user uploads, you need automation.

VectoSolve offers several ways to automate vectorization at scale. This guide covers all of them.

Option 1: The Batch API Endpoint

The VectoSolve API has a dedicated batch endpoint that processes up to 10 images in a single request. Each image can have a different operation.

curl -X POST https://vectosolve.com/api/v1/batch \
  -H "Authorization: Bearer vs_your_key" \
  -H "Content-Type: application/json" \
  -d '{"images": [{"url": "https://example.com/logo.png", "operation": "vectorize"}, {"url": "https://example.com/photo.jpg", "operation": "remove_bg"}]}'

The response includes results for each image individually, so if one fails, the others still succeed. Failed images are automatically refunded.

Batch Pricing

Credits are deducted upfront, then refunded for any failed images. See pricing.

Option 2: The TypeScript SDK

The official SDK wraps the API with typed methods.

import VectoSolve from '@vectosolve/sdk';
const client = new VectoSolve({ apiKey: process.env.VECTOSOLVE_API_KEY });

const files = await readdir('./images');
for (const file of files.filter(f => f.endsWith('.png'))) {
  const result = await client.vectorize(`./images/${file}`);
  console.log(`${file}: ${result.credits.remaining} credits remaining`);
}

Install with npm install @vectosolve/sdk. Full documentation in the developer ecosystem article.

Option 3: GitHub Actions (CI/CD)

The VectoSolve GitHub Action vectorizes images automatically when pushed to a repository.

name: Vectorize new images
on:
  push:
    paths: ['assets/raster/**']
jobs:
  vectorize:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Vectosolve/vectosolve-action@v1
        with:
          api-key: ${{ secrets.VECTOSOLVE_API_KEY }}
          input-dir: assets/raster
          output-dir: assets/vector

Option 4: MCP Server (AI-Assisted)

The VectoSolve MCP server lets you vectorize images through natural language in Claude Code, Cursor, or Windsurf. Covered in our MCP server tutorial.

Error Handling and Rate Limits

Rate Limits

Default: 60 requests per minute per API key. Batch counts each image as one request. Contact us for higher limits.

Automatic Refunds

VectoSolve uses debit-before-process: credits deducted before conversion, automatically refunded on failure.

Real-World Example: E-Commerce Catalog

An Etsy seller with 200 product photos needs SVG versions:

const client = new VectoSolve({ apiKey: 'vs_...' });
for (const product of products) {
  const noBg = await client.removeBackground(product.imageUrl);
  const svg = await client.vectorize(noBg.data.image);
  await saveToStore(product.id, svg.data.svg);
}

At $0.27 per image, the entire catalog costs $54. Compare that to hours of manual work in Adobe Illustrator or Canva.

Choosing the Right Approach

For a full overview, see the developer ecosystem guide. For API reference: vectosolve.com/developers.