El mismo motor, en el servidor.

Las solicitudes anónimas funcionan, con límites estrictos. Una clave los eleva y se envía como token de portador (bearer). Una clave que no reconocemos —incluida una revocada— se rechaza con 401 en lugar de degradarse en silencio al nivel anónimo, y el rechazo cuenta contra el presupuesto de tu IP: una degradación silenciosa convertiría una errata en un error de límite de tasa una hora después.

Authorization: Bearer $VECTORTRACE_KEY

Las claves se crean en la página de tu cuenta y se muestran una sola vez; solo se guarda un hash. Forman parte de Pro: se incluyen 500 imágenes al mes, y cada imagen adicional cuesta 0,02 €, facturada a través de tu suscripción. Revoca una clave en la página de tu cuenta y deja de funcionar en la siguiente solicitud. La gestión de claves es una superficie del navegador, autenticada por la cookie de sesión y verificada por origen; está documentada en el archivo OpenAPI para que un cliente vea las formas, pero no está pensada para automatizarse.

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 }

Gestionar claves en tu cuenta

Vectoriza una imagen ráster. Envíala como parte multipart o en base64 dentro de un cuerpo JSON. La respuesta es el propio archivo vectorial, o el documento en JSON si lo solicitas.

PNG · JPG · JPEG · WebP · BMP · GIF

Solicitud

Ejemplos

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)

Cuerpo JSON

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

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

Todos los campos son opcionales. Un preajuste rellena el resto; un campo que definas prevalece sobre el preajuste. Son los mismos controles que el inspector del convertidor, y la misma tabla que lee el motor en Rust.

Éxito

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

Toda respuesta incluye las cabeceras de límite de tasa, se rechace o no. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Formato de error

Un único formato, siempre. Distingue por el código, nunca por el texto: el código es estable y el mensaje no.

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

Una imagen que supera el límite de píxeles se rechaza, no se reduce. El convertidor de tu navegador reduce las obras de gran tamaño porque la alternativa es una reserva de un cuarto de gigabyte en tu propia pestaña; aquí el límite es un presupuesto, y devolver coordenadas que no encajan con la obra enviada sería peor que un error.

La referencia de arriba se genera a partir de los mismos esquemas zod con los que valida el servidor, así que no hay una especificación escrita a mano que pueda desactualizarse. Apunta a ella un generador de clientes.

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

/api/openapi.json

Un resumen en texto plano del producto, las páginas y este endpoint, escrito para modelos de lenguaje y agentes. La versión completa añade el índice de páginas y la tabla de preajustes.

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

El motor como comando. Los mismos preajustes, la misma salida, sin servidor de por medio.

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

Un servidor MCP que expone el motor a agentes por stdio o HTTP en streaming. Tres herramientas: