O mesmo mecanismo, no servidor.

Requisições anônimas funcionam, com limites reduzidos. Uma chave eleva esses limites e é enviada como bearer token. Uma chave que não reconhecemos — incluindo uma que foi revogada — é recusada com 401 em vez de ser silenciosamente rebaixada ao nível anônimo, e a recusa conta contra o orçamento do seu IP: um rebaixamento silencioso transformaria um erro de digitação em um erro de limite de taxa uma hora depois.

Authorization: Bearer $VECTORTRACE_KEY

As chaves são criadas na página da sua conta e exibidas uma única vez; apenas um hash é armazenado. Elas fazem parte do Pro: 500 imagens por mês estão incluídas, e cada imagem além disso custa € 0,02, cobrada através da sua assinatura. Revogue uma chave na página da conta e ela para de funcionar na próxima requisição. O gerenciamento de chaves é uma superfície de navegador, autenticada pelo cookie de sessão e verificada por origem — está documentado no arquivo OpenAPI para que um cliente veja os formatos, mas não é pensado para ser automatizado por script.

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 }

Gerenciar chaves na sua conta

Vetorize uma imagem raster. Envie-a como parte multipart ou em base64 dentro de um corpo JSON. A resposta é o próprio arquivo vetorial, ou o documento em JSON quando solicitado.

PNG · JPG · JPEG · WebP · BMP · GIF

Requisição

Exemplos

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)

Corpo JSON

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

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

Todo campo é opcional. Um preset preenche o restante; um campo que você define prevalece sobre o preset. São os mesmos controles do inspetor do conversor, e a mesma tabela que o mecanismo em Rust lê.

Sucesso

{
  "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 resposta carrega os cabeçalhos de limite de taxa, recusada ou não. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Envelope de erro

Um único envelope, sempre. Baseie a lógica no código, nunca no texto — o código é estável e a mensagem não é.

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

Uma imagem acima do limite de pixels é recusada, não reduzida. O conversor no seu navegador reduz artes grandes demais porque a alternativa seria alocar um quarto de gigabyte na sua própria aba; aqui o limite é um orçamento, e devolver coordenadas que não correspondem à arte enviada seria pior do que um erro.

A referência acima é gerada a partir dos mesmos esquemas zod que o servidor usa para validar, então não existe uma especificação escrita à mão para ficar desatualizada. Aponte um gerador de cliente para ela.

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

/api/openapi.json

Um resumo em texto simples do produto, das páginas e deste endpoint, escrito para modelos de linguagem e agentes. A versão completa acrescenta o índice de páginas e a tabela de presets.

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

O mecanismo como um comando. Mesmos presets, mesma saída, sem servidor no meio do caminho.

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

Um servidor MCP que expõe o mecanismo a agentes via stdio ou HTTP streamable. Três ferramentas: