Le même moteur, côté serveur.

Les requêtes anonymes fonctionnent, avec des limites strictes. Une clé les relève et se transmet comme jeton porteur (bearer). Une clé non reconnue — y compris une clé révoquée — est refusée avec un 401 plutôt que rétrogradée silencieusement vers le niveau anonyme, et le refus est décompté du budget de votre IP : une rétrogradation silencieuse transformerait une faute de frappe en erreur de limite de débit une heure plus tard.

Authorization: Bearer $VECTORTRACE_KEY

Les clés se créent sur la page de votre compte et ne s'affichent qu'une fois ; seul un hachage est conservé. Elles font partie de Pro : 500 images par mois sont incluses, et chaque image supplémentaire coûte 0,02 €, facturée via votre abonnement. Révoquez une clé sur la page de votre compte et elle cesse de fonctionner dès la requête suivante. La gestion des clés est une surface navigateur, authentifiée par le cookie de session et vérifiée par origine — elle est documentée dans le fichier OpenAPI pour qu'un client puisse en voir les formes, mais elle n'est pas destinée à être scriptée.

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 }

Gérer les clés sur votre compte

Vectorisez une image raster. Envoyez-la comme partie multipart ou en base64 dans un corps JSON. La réponse est le fichier vectoriel lui-même, ou le document en JSON si vous le demandez.

PNG · JPG · JPEG · WebP · BMP · GIF

Requête

Exemples

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)

Corps JSON

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

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

Chaque champ est optionnel. Un preset renseigne le reste ; un champ défini l'emporte sur le preset. Ce sont les mêmes réglages que l'inspecteur du convertisseur, et la même table que celle lue par le moteur Rust.

Succès

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

Chaque réponse porte les en-têtes de limite de débit, refusée ou non. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Enveloppe d'erreur

Une seule enveloppe, toujours. Décidez sur le code, jamais sur le texte — le code est stable et le message ne l'est pas.

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

Une image dépassant la limite de pixels est refusée, non réduite. Le convertisseur de votre navigateur réduit les visuels trop grands parce que l'alternative est une allocation d'un quart de gigaoctet dans votre propre onglet ; ici le plafond est un budget, et renvoyer des coordonnées qui ne correspondent pas au visuel envoyé serait pire qu'une erreur.

La référence ci-dessus est générée à partir des mêmes schémas zod que ceux utilisés pour la validation côté serveur, donc il n'existe aucune spécification écrite à la main susceptible de se désynchroniser. Pointez un générateur de client dessus.

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

/api/openapi.json

Un résumé en texte brut du produit, des pages et de cet endpoint, rédigé pour les modèles de langage et les agents. La version complète ajoute l'index des pages et la table des presets.

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

Le moteur sous forme de commande. Mêmes presets, même sortie, aucun serveur dans la boucle.

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

Un serveur MCP exposant le moteur aux agents via stdio ou HTTP en flux continu. Trois outils :