同一引擎,运行在服务器端。

匿名请求可以使用,但限额较严格。密钥可以提升限额,以 Bearer 令牌形式发送。系统无法识别的密钥 —— 包括已撤销的密钥 —— 会直接以 401 拒绝,而不是悄悄降级到匿名档位;这次拒绝仍会计入您所在 IP 的额度:静默降级只会让一个拼写错误在一小时后变成一次速率限制错误。

Authorization: Bearer $VECTORTRACE_KEY

密钥在您的账户页面创建,仅显示一次;系统只保存其哈希值。密钥是 Pro 的功能之一:每月包含 500 张图像,超出部分每张 €0.02,通过您的订阅计费。在账户页面撤销密钥后,下一次请求即失效。密钥管理是一个浏览器端功能,通过会话 Cookie 认证并校验来源 —— 该功能已在 OpenAPI 文件中记录,便于客户端了解其数据结构,但并非为脚本化调用而设计。

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 }

在账户中管理密钥

对一张栅格图像进行矢量化。可以作为 multipart 文件部分发送,也可以作为 base64 编码放入 JSON 请求体。响应即为矢量文件本身,或在您指定时以 JSON 形式返回文档。

PNG · JPG · JPEG · WebP · BMP · GIF

请求

示例

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 请求体

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

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

所有字段均为可选。预设会为未指定的字段填充默认值;您设置的字段优先于预设。这些选项与转换器检查器面板中的控件完全相同,也是 Rust 引擎读取的同一张表。

成功

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

无论请求被拒绝与否,每个响应都携带速率限制相关的响应头。 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

错误信封

错误始终使用同一种信封格式。请根据错误码分支处理,而不是根据文字描述 —— 错误码是稳定的,提示文字则不是。

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

超过像素限制的图像会被直接拒绝,而不是缩小处理。浏览器内的转换器会缩小过大的作品,因为不这样做就要在您自己的标签页中分配四分之一 GB 的内存;而在这里,限额是一种资源预算 —— 返回与您提交的原图不对应的坐标,后果会比报错更糟。

以上参考文档由服务器校验所用的同一套 zod schema 生成,因此不存在手写文档过时的问题。可以直接指向它生成客户端代码。

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

/api/openapi.json

一份面向语言模型与智能体的纯文本摘要,概述产品、各个页面及此接口。完整版还包含页面索引和预设表。

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

以命令行形式提供的引擎。相同的预设,相同的输出,过程中不涉及服务器。

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

一个通过 stdio 或可流式传输的 HTTP 向智能体开放引擎的 MCP 服务器。提供三个工具: