Lo stesso motore, lato server.

Le richieste anonime funzionano, con limiti stretti. Una chiave li innalza e viene inviata come bearer token. Una chiave che non riconosciamo — inclusa una revocata — viene rifiutata con 401 invece di essere silenziosamente declassata al livello anonimo, e il rifiuto conta sul budget del tuo IP: un declassamento silenzioso trasformerebbe un errore di battitura in un errore di limite di frequenza un'ora dopo.

Authorization: Bearer $VECTORTRACE_KEY

Le chiavi si creano nella pagina del tuo account e vengono mostrate una sola volta; viene memorizzato solo un hash. Fanno parte di Pro: 500 immagini al mese sono incluse, e ogni immagine oltre quella soglia costa 0,02 €, fatturata tramite il tuo abbonamento. Revoca una chiave nella pagina dell'account e smetterà di funzionare alla richiesta successiva. La gestione delle chiavi è una superficie da browser, autenticata dal cookie di sessione e verificata sull'origine — è documentata nel file OpenAPI così un client può vederne le forme, ma non è pensata per essere scriptata.

GET    /api/account/keys            → { keys, usage, maxKeys }
POST   /api/account/keys  { name }  → { key, secret }   # secret shown once
DELETE /api/account/keys/{id}       → { revoked: true, id }

Gestisci le chiavi nel tuo account

Vettorizza un'immagine raster. Inviala come parte multipart o come base64 dentro un corpo JSON. La risposta è il file vettoriale stesso, oppure il documento come JSON se lo richiedi.

PNG · JPG · JPEG · WebP · BMP · GIF

Richiesta

Esempi

curl -X POST "https://vectortrace.app/api/v1/vectorize?format=svg" \
  -H "Authorization: Bearer $VECTORTRACE_KEY" \
  -F "image=@logo.png" \
  -F 'options={"preset":"logo","colors":8}' \
  -o logo.svg

import { readFile, writeFile } from 'node:fs/promises'

const form = new FormData()
form.append('image', new Blob([await readFile('logo.png')]), 'logo.png')
form.append('options', JSON.stringify({ preset: 'logo', colors: 8 }))

const response = await fetch('https://vectortrace.app/api/v1/vectorize?format=svg', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.VECTORTRACE_KEY}` },
  body: form,
})
if (!response.ok) throw new Error(await response.text())
await writeFile('logo.svg', Buffer.from(await response.arrayBuffer()))

import json, os, requests

with open("logo.png", "rb") as image:
    response = requests.post(
        "https://vectortrace.app/api/v1/vectorize",
        params={"format": "svg"},
        headers={"Authorization": f"Bearer {os.environ['VECTORTRACE_KEY']}"},
        files={"image": image},
        data={"options": json.dumps({"preset": "logo", "colors": 8})},
    )
response.raise_for_status()
open("logo.svg", "wb").write(response.content)

Corpo JSON

POST /api/v1/vectorize?format=svg
Content-Type: application/json
Accept: application/json

{
  "image": "iVBORw0KGgoAAAANSUhEUgAA…",
  "options": { "preset": "logo", "colors": 8 }
}

Ogni campo è opzionale. Un preset compila il resto; un campo che imposti prevale sul preset. Sono gli stessi controlli dell'ispettore del convertitore, e la stessa tabella letta dal motore Rust.

Successo

{
  "document": {
    "version": 1, "width": 512, "height": 512, "unit": "px",
    "palette": ["#101114", "#e8491d"],
    "elements": [{ "kind": "path", "fill": 0, "stroke": null, "subpaths": [ … ] }]
  },
  "stats": { "paths": 12, "nodes": 184, "colors": 2, "ms": 41, "estimatedSvgBytes": 3210 }
}

Ogni risposta porta le intestazioni di limite di frequenza, rifiutata o no. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Busta di errore

Una busta, sempre. Basa la logica sul codice, mai sul testo — il codice è stabile e il messaggio no.

{ "error": { "code": "IMAGE_TOO_LARGE", "message": "…" } }

Un'immagine oltre il limite di pixel viene rifiutata, non ridimensionata. Il convertitore nel tuo browser riduce le opere sovradimensionate perché l'alternativa è un'allocazione di un quarto di gigabyte nella tua stessa scheda; qui il tetto è un budget, e restituire coordinate che non corrispondono all'opera inviata sarebbe peggio di un errore.

Il riferimento qui sopra è generato dagli stessi schemi zod con cui valida il server, quindi non esiste una specifica scritta a mano che possa disallinearsi. Punta un generatore di client verso di essa.

GET https://vectortrace.app/api/openapi.json

/api/openapi.json

Un riepilogo in testo semplice del prodotto, delle pagine e di questo endpoint, scritto per modelli linguistici e agenti. La versione completa aggiunge l'indice delle pagine e la tabella dei preset.

GET https://vectortrace.app/llms.txt
GET https://vectortrace.app/llms-full.txt

Il motore come comando. Stessi preset, stesso output, nessun server nel ciclo.

npx @vectortrace/cli in.png -o out.svg --preset laser

Un server MCP che espone il motore agli agenti su stdio o streamable HTTP. Tre strumenti: