API dokümantasyonu

Vektörleştirmeyi kendi uygulamandan programatik olarak çağır. Anahtar oluşturmak için API erişimi sayfasına giriş yap. Her başarılı istek 1 kredi harcar.

Kimlik doğrulama

Her istekte Authorization: Bearer <anahtar> başlığını gönder. Anahtarlar pv_live_ ile başlar.

Uç nokta

POST https://pixovec.com/api/v1/vectorize

Form alanları

file zorunlu — resim dosyası (PNG, JPG, WebP, BMP)
preset opsiyonel — photo | logo | lineart | poster (varsayılan: logo)
mode opsiyonel — color | bw, preset'in modunu geçersiz kılar

Yanıt formatı

Varsayılan olarak JSON döner. ?format=svg eklersen yanıt doğrudan ham SVG (content-type: image/svg+xml) olur.

JSON isteği

curl -X POST https://pixovec.com/api/v1/vectorize \
  -H "Authorization: Bearer pv_live_..." \
  -F "file=@logo.png" \
  -F "preset=logo"

JSON yanıtı

{
  "svg": "<svg ...>...</svg>",
  "colorCount": 8,
  "width": 512,
  "height": 512,
  "balance": 42
}

Doğrudan SVG indirme

curl -X POST "https://pixovec.com/api/v1/vectorize?format=svg" \
  -H "Authorization: Bearer pv_live_..." \
  -F "file=@logo.png" \
  -F "preset=logo" \
  -o logo.svg

Hata kodları

401missing_api_keyAuthorization başlığı yok.

401invalid_api_keyAnahtar geçersiz veya iptal edilmiş.

400missing_filemultipart/form-data içinde 'file' alanı yok.

400invalid_fileDosya okunamadı.

422vectorize_failedVektörleştirme başarısız oldu (bozuk/desteklenmeyen görsel).

402insufficient_creditsKredi bakiyesi yetersiz.

500spend_failedKredi düşme işlemi başarısız oldu.

API anahtarı oluştur