동일한 엔진을, 서버에서.

익명 요청도 가능하지만 한도가 엄격합니다. 키가 있으면 한도가 올라가며, Bearer 토큰으로 전송됩니다. 인식되지 않는 키(폐기된 키 포함)는 조용히 익명 등급으로 낮춰지지 않고 401로 거부되며, 이 거부는 해당 IP의 예산에도 반영됩니다. 조용히 강등되면 오타 하나가 한 시간 뒤에야 요청 제한 오류로 나타나게 됩니다.

Authorization: Bearer $VECTORTRACE_KEY

키는 계정 페이지에서 생성되며 한 번만 표시됩니다. 저장되는 것은 해시뿐입니다. 키는 Pro 기능의 일부로, 월 500장의 이미지가 포함되며 초과분은 장당 €0.02가 구독을 통해 청구됩니다. 계정 페이지에서 키를 폐기하면 다음 요청부터 작동하지 않습니다. 키 관리는 세션 쿠키로 인증되고 오리진이 검사되는 브라우저 화면입니다 — 클라이언트가 형태를 확인할 수 있도록 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 파일 파트로 보내거나 JSON 본문 안에 base64로 보낼 수 있습니다. 응답은 벡터 파일 자체이거나, 요청 시 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": "…" } }

픽셀 한도를 초과한 이미지는 축소되지 않고 거부됩니다. 브라우저 내 변환기는 과대한 아트워크를 축소하는데, 그 이유는 대안이 여러분의 탭에서 250메가바이트 규모의 메모리 할당을 요구하기 때문입니다. 여기서 한도는 예산의 문제이며, 보낸 아트워크와 맞지 않는 좌표를 반환하는 것은 오류보다 더 나쁩니다.

위 레퍼런스는 서버가 검증에 사용하는 것과 동일한 zod 스키마에서 생성되므로, 스펙이 손으로 작성되어 어긋날 일이 없습니다. 클라이언트 생성기를 여기에 연결하세요.

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 또는 streamable HTTP를 통해 엔진을 에이전트에 노출하는 MCP 서버입니다. 세 가지 도구가 있습니다: