Aynı motor, sunucu tarafında.

Anonim istekler sıkı sınırlarla çalışır. Bir anahtar bu sınırları yükseltir ve bearer token olarak gönderilir. Tanımadığımız bir anahtar — iptal edilmiş olan da dahil — sessizce anonim katmana düşürülmek yerine 401 ile reddedilir ve bu ret IP'nizin bütçesinden düşer: sessiz bir düşürme, bir yazım hatasını bir saat sonra bir hız sınırı hatasına dönüştürür.

Authorization: Bearer $VECTORTRACE_KEY

Anahtarlar hesap sayfanızda oluşturulur ve bir kez gösterilir; yalnızca özeti saklanır. Pro'nun bir parçasıdır: ayda 500 görsel dahildir, üzerindeki her görsel €0,02 tutarındadır ve aboneliğiniz üzerinden faturalandırılır. Bir anahtarı hesap sayfasında iptal edin; bir sonraki istekte çalışmayı durdurur. Anahtar yönetimi bir tarayıcı yüzeyidir, oturum çerezi ile kimliği doğrulanır ve kökeni denetlenir — bir istemcinin şekilleri görebilmesi için OpenAPI dosyasında belgelenir, ama betiklenmek üzere tasarlanmamıştır.

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 }

Hesabınızdaki anahtarları yönetin

Tek bir raster görseli vektörleştirin. Onu bir multipart dosya parçası olarak veya bir JSON gövdesi içinde base64 olarak gönderin. Yanıt, vektör dosyasının kendisi veya istediğinizde JSON olarak belgedir.

PNG · JPG · JPEG · WebP · BMP · GIF

İstek

Örnekler

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 gövdesi

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

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

Her alan isteğe bağlıdır. Bir ön ayar geri kalanını doldurur; ayarladığınız bir alan ön ayara üstün gelir. Bunlar dönüştürücünün denetleyicisiyle aynı kontroller ve Rust motorunun okuduğu aynı tablodur.

Başarılı

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

Her yanıt, reddedilsin ya da edilmesin, hız sınırı başlıklarını taşır. X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Hata zarfı

Her zaman tek bir zarf. Metne değil koda göre dallanın — kod kararlıdır, metin değil.

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

Piksel sınırının üzerindeki bir görsel küçültülmez, reddedilir. Tarayıcınızdaki dönüştürücü aşırı büyük eserleri küçültür, çünkü alternatifi kendi sekmenizde çeyrek gigabaytlık bir ayırmadır; burada tavan bir bütçedir ve gönderdiğiniz esere oturmayan koordinatlar döndürmek bir hatadan daha kötü olurdu.

Yukarıdaki referans, sunucunun doğrulamada kullandığı aynı zod şemalarından üretilir, bu yüzden güncelliğini yitirebilecek elle yazılmış bir spesifikasyon yoktur. Bir istemci üreticisini buna yönlendirin.

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

/api/openapi.json

Ürünün, sayfaların ve bu uç noktanın dil modelleri ve etmenler için yazılmış düz metin özeti. Tam sürüm, sayfa dizinini ve ön ayar tablosunu ekler.

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

Motor, bir komut olarak. Aynı ön ayarlar, aynı çıktı, aradaki döngüde sunucu yok.

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

Motoru stdio veya akışlı HTTP üzerinden etmenlere açan bir MCP sunucusu. Üç araç: