同じエンジンを、サーバーサイドで。

匿名リクエストも動作しますが、上限は厳しめです。キーを使うとその上限が引き上げられ、Bearerトークンとして送信します。認識できないキー（失効済みのキーを含む）は、匿名ティアへ静かに切り替えるのではなく401で拒否され、この拒否はIPの予算に計上されます — 静かな降格は、タイプミスを1時間後のレート制限エラーに変えてしまうためです。

Authorization: Bearer $VECTORTRACE_KEY

キーはアカウントページで作成され、一度だけ表示されます。保存されるのはハッシュのみです。キーはProの機能で、月間500枚の画像が含まれ、それを超える画像1枚ごとに€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 }

アカウントページでキーを管理

ラスター画像を1枚ベクター化します。マルチパートのファイルパートとして、または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

エラーエンベロープ

エンベロープは常に1種類です。コードで分岐し、文言では分岐しないでください — コードは安定していますが、メッセージは変わる可能性があります。

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

ピクセル数上限を超える画像は縮小されるのではなく拒否されます。ブラウザ内のコンバーターがサイズ超過のアートワークを縮小するのは、代わりに4分の1ギガバイト級のメモリ確保がお使いのタブ内で発生してしまうからです。一方このAPIでは上限は予算であり、送信したアートワークに対応しない座標を返すのはエラーより悪い結果になります。

上記のリファレンスは、サーバーの検証に使うのと同じ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サーバーです。3つのツールがあります。