Dieselbe Engine, serverseitig.

Anonyme Anfragen funktionieren, mit engen Limits. Ein Schlüssel hebt sie an und wird als Bearer-Token gesendet. Ein Schlüssel, den wir nicht kennen — auch ein widerrufener —, wird mit 401 abgelehnt statt still auf die anonyme Stufe herabgestuft, und die Ablehnung geht zulasten des Budgets Ihrer IP: Eine stille Herabstufung würde aus einem Tippfehler eine Stunde später einen Rate-Limit-Fehler machen.

Authorization: Bearer $VECTORTRACE_KEY

Schlüssel werden auf Ihrer Kontoseite erstellt und einmalig angezeigt; gespeichert wird nur ein Hash. Sie sind Teil von Pro: 500 Bilder im Monat sind enthalten, jedes weitere Bild kostet 0,02 € und wird über Ihr Abo abgerechnet. Widerrufen Sie einen Schlüssel auf der Kontoseite, funktioniert er ab der nächsten Anfrage nicht mehr. Die Schlüsselverwaltung ist eine Browser-Oberfläche, authentifiziert über das Sitzungs-Cookie und Origin-geprüft — sie ist in der OpenAPI-Datei dokumentiert, damit ein Client die Formen sehen kann, ist aber nicht zum Skripten gedacht.

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 }

Schlüssel in Ihrem Konto verwalten

Vektorisieren Sie ein Rasterbild. Senden Sie es als Multipart-Dateiteil oder als Base64 innerhalb eines JSON-Bodys. Die Antwort ist die Vektordatei selbst oder das Dokument als JSON, wenn Sie das anfordern.

PNG · JPG · JPEG · WebP · BMP · GIF

Anfrage

Beispiele

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

Jedes Feld ist optional. Ein Preset füllt den Rest aus; ein von Ihnen gesetztes Feld gewinnt gegenüber dem Preset. Das sind dieselben Regler wie im Inspector des Konverters und dieselbe Tabelle, die die Rust-Engine liest.

Erfolg

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

Jede Antwort trägt die Rate-Limit-Header, ob abgelehnt oder nicht. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Fehler-Envelope

Immer ein einziges Envelope. Verzweigen Sie auf den Code, nie auf den Text — der Code ist stabil, der Text nicht.

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

Ein Bild über dem Pixel-Limit wird abgelehnt, nicht herunterskaliert. Der Konverter in Ihrem Browser verkleinert übergroßes Artwork, weil die Alternative eine Viertel-Gigabyte-Allokation im eigenen Tab wäre; hier ist die Obergrenze ein Budget, und Koordinaten zurückzugeben, die nicht auf das gesendete Artwork passen, wäre schlimmer als ein Fehler.

Die obige Referenz wird aus denselben Zod-Schemas generiert, mit denen der Server validiert — es gibt also keine handgeschriebene Spezifikation, die veralten könnte. Richten Sie einen Client-Generator darauf aus.

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

/api/openapi.json

Eine Klartext-Zusammenfassung des Produkts, der Seiten und dieses Endpunkts, geschrieben für Sprachmodelle und Agenten. Die vollständige Version ergänzt den Seitenindex und die Preset-Tabelle.

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

Die Engine als Kommando. Dieselben Presets, dieselbe Ausgabe, kein Server im Spiel.

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

Ein MCP-Server, der die Engine Agenten über stdio oder streamable HTTP zur Verfügung stellt. Drei Tools: