Ten sam silnik, po stronie serwera.

Żądania anonimowe działają, z niskimi limitami. Klucz je podnosi i jest wysyłany jako token bearer. Klucz, którego nie rozpoznajemy — także taki, który został odwołany — jest odrzucany z kodem 401, a nie po cichu obniżany do poziomu anonimowego, a odmowa liczy się do budżetu Twojego IP: ciche obniżenie zmieniłoby literówkę w błąd limitu żądań godzinę później.

Authorization: Bearer $VECTORTRACE_KEY

Klucze tworzy się na stronie konta i pokazywane są raz; przechowywany jest tylko ich skrót. Są częścią Pro: 500 obrazów miesięcznie jest wliczone, a każdy kolejny obraz kosztuje 0,02 €, rozliczane w ramach subskrypcji. Odwołaj klucz na stronie konta, a przestanie działać przy następnym żądaniu. Zarządzanie kluczami to funkcja przeglądarki, uwierzytelniana ciasteczkiem sesji i sprawdzana pod kątem pochodzenia — jest udokumentowana w pliku OpenAPI, żeby klient mógł zobaczyć kształty danych, ale nie jest przeznaczona do skryptowania.

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 }

Zarządzaj kluczami na koncie

Wektoryzuje jeden obraz rastrowy. Wyślij go jako część multipart lub jako base64 w treści JSON. Odpowiedzią jest sam plik wektorowy albo dokument w formacie JSON, gdy o to poprosisz.

PNG · JPG · JPEG · WebP · BMP · GIF

Żądanie

Przykłady

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)

Treść JSON

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

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

Każde pole jest opcjonalne. Preset uzupełnia resztę; pole, które ustawisz, ma pierwszeństwo przed presetem. To te same ustawienia co w panelu konwertera i ta sama tabela, którą odczytuje silnik w Rust.

Sukces

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

Każda odpowiedź niesie nagłówki limitu żądań, odrzucona czy nie. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Koperta błędu

Zawsze jedna koperta. Rozgałęziaj na podstawie kodu, nigdy na podstawie treści — kod jest stabilny, a komunikat nie.

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

Obraz przekraczający limit pikseli jest odrzucany, a nie pomniejszany. Konwerter w Twojej przeglądarce zmniejsza zbyt duże grafiki, bo alternatywą jest alokacja ćwierć gigabajta w Twojej własnej karcie; tutaj limit jest budżetem, a zwrócenie współrzędnych, które nie odpowiadają wysłanej grafice, byłoby gorsze niż błąd.

Powyższa dokumentacja jest generowana z tych samych schematów zod, którymi waliduje serwer, więc nie ma ręcznie pisanej specyfikacji, która mogłaby się zdezaktualizować. Skieruj na nią generator klienta.

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

/api/openapi.json

Podsumowanie produktu, stron i tego punktu końcowego w czystym tekście, napisane z myślą o modelach językowych i agentach. Pełna wersja dodaje indeks stron i tabelę presetów.

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

Silnik jako polecenie. Te same presety, ten sam wynik, bez serwera w pętli.

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

Serwer MCP udostępniający silnik agentom przez stdio lub streamable HTTP. Trzy narzędzia: