Dezelfde engine, serverside.

Anonieme verzoeken werken, met strakke limieten. Een sleutel tilt deze op en wordt meegestuurd als bearer-token. Een sleutel die we niet herkennen — ook een ingetrokken sleutel — wordt geweigerd met 401 in plaats van stilzwijgend teruggezet naar de anonieme laag, en de weigering telt mee in het budget van je IP-adres: een stille terugval maakt van een typefout een uur later een rate-limit-fout.

Authorization: Bearer $VECTORTRACE_KEY

Sleutels worden aangemaakt op je accountpagina en eenmalig getoond; alleen een hash wordt bewaard. Ze horen bij Pro: 500 afbeeldingen per maand zijn inbegrepen, en elke afbeelding daarna kost € 0,02, gefactureerd via je abonnement. Trek een sleutel in op de accountpagina en hij stopt met werken bij het volgende verzoek. Sleutelbeheer is een browservoorziening, geverifieerd met het sessiecookie en met origin-controle — het is gedocumenteerd in het OpenAPI-bestand zodat een client de vormen kan zien, maar het is niet bedoeld om te scripten.

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 }

Beheer sleutels op je account

Vectoriseer één rasterafbeelding. Stuur deze als multipart-bestandsdeel of als base64 in een JSON-body. De respons is het vectorbestand zelf, of het document als JSON wanneer je daarom vraagt.

PNG · JPG · JPEG · WebP · BMP · GIF

Verzoek

Voorbeelden

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)

JSON-body

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

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

Elk veld is optioneel. Een preset vult de rest aan; een veld dat je zelf instelt wint van de preset. Dit zijn dezelfde besturingselementen als het inspectorpaneel van de converter, en dezelfde tabel die de Rust-engine leest.

Succes

{
  "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 }
}

Elk antwoord bevat de rate-limit-headers, geweigerd of niet. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Foutenvelop

Eén envelop, altijd. Vertak op de code, nooit op de tekst — de code is stabiel en de boodschap niet.

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

Een afbeelding boven de pixellimiet wordt geweigerd, niet verkleind. De converter in je browser verkleint te grote werkstukken omdat het alternatief een allocatie van een kwart gigabyte in je eigen tabblad is; hier is het plafond een budget, en coördinaten teruggeven die niet op het door jou verzonden werkstuk passen zou erger zijn dan een fout.

De referentie hierboven wordt gegenereerd uit dezelfde zod-schema's waarmee de server valideert, dus er is geen handgeschreven specificatie die achter kan raken. Richt een clientgenerator erop.

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

/api/openapi.json

Een platte-tekstsamenvatting van het product, de pagina's en dit endpoint, geschreven voor taalmodellen en agents. De volledige versie voegt de pagina-index en de presettabel toe.

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

De engine als commando. Dezelfde presets, dezelfde uitvoer, geen server in de keten.

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

Een MCP-server die de engine aan agents blootstelt via stdio of streamable HTTP. Drie tools: