PixelToPath API

Hızlı Başlangıç

Terminalinizden, betiklerden veya uygulamanızdan görselleri SVG'ye dönüştürmeye başlamak için üç adım yeterli.

İlk dönüştürmeniz

curl -sS -f -X POST https://api.pixel-to-path.com/v1/convert \
  -H "Authorization: Bearer ptp_live_YOUR_KEY" \
  -F "[email protected]" \
  -F "colormode=binary" \
  -o logo.svg

Etkileşimli referans: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Kimlik Doğrulama

Her istek, Authorization başlığındaki bir Bearer token ile doğrulanır:

Authorization: Bearer ptp_live_0123abc…

• Anahtarlar gizlidir: sunucu tarafında hash'lenmiş olarak saklanırlar ve yalnızca oluşturulduklarında bir kez görüntülenirler. Anahtarınızı mı kaybettiniz? İptal edin ve yeni bir tane oluşturun.
• Bir hesap, birden fazla anahtar: projelerinizi ayırmak için 5 adede kadar aktif anahtar oluşturun. Aylık ücretsiz kotanız anahtar başına değil, hesap başına sayılır.
• Anında iptal: iptal edilen bir anahtar, portaldan veya yasaklanmış bir hesabın API yanıtından anında çalışmayı durdurur.

POST /v1/convert

Tek bir durumsuz (stateless) çağrıda yükleme + dönüştürme. Başarılı bir çağrı en fazla 1 krediye mal olur — başarısız, geçersiz veya hız sınırına (rate-limited) takılan çağrılar ücretlendirilmez.

İstek (multipart/form-data)

İki motor, "colormode" ile seçilir

API, ücretsiz çevrimiçi dönüştürücü ve masaüstü uygulaması ile tamamen aynı motorları çalıştırır:

Görseller web sitesindeki gibi ön işleme tabi tutulur: dönüştürmeden önce en uzun kenar 1500 piksele yeniden boyutlandırılır ve API, algılanan görsel türünü (line_art, logo, photo veya illustration) X-Detected-Type başlığında döndürür.

Yanıt

Başarılı olduğunda: image/svg+xml ile 200 OK — gövde (body) SVG dosyasının kendisidir. Bilgilendirici başlıklar:

GET /v1/me

Bunu çağırmak için kullanılan anahtarın hesap durumu. Ücretsizdir — asla kotanızdan düşülmez veya bakiyenizden harcanmaz.

Örnek yanıt

GET /v1/me
Authorization: Bearer ptp_live_…

{
  "key": { "name": "prod", "prefix": "ptp_live_0123abc", … },
  "usage": {
    "month": "2026-09", "free_used": 7, "free_limit": 10,
    "free_remaining": 3, "resets_at": "2026-10-01T00:00:00+00:00"
  },
  "credits": { "balance": 120 }
}

Hatalar

Her hata tutarlı bir JSON zarfı döndürür. Başarısız çağrılar asla kredi tüketmez.

HTTP/1.1 402 Payment Required
{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly free quota used and no credits left.",
    "usage": { "free_used": 10, "free_limit": 10, "credits": 0 }
  }
}

Hız sınırları

Sınırlar IP başına değil, API anahtarı başına uygulanır; böylece paylaşımlı bir ofis veya CI koşucusu asla başkasının trafiği yüzünden cezalandırılmaz.

Fiyatlandırma

Her yeni hesap her ay 10 ücretsiz dönüştürme elde eder, kredi kartı gerekmez. Daha fazlasına mı ihtiyacınız var? Ön ödemeli görseller satın alın — hacim indirimleriyle dilediğiniz miktarda (50'lik partiler halinde). Süreleri asla dolmaz ve aylık ücretsiz kotanıza eklenirler (önce ücretsiz dönüştürmeler tüketilir).

Otomatik kredi: Bakiyeniz, ödeme webhook'u aracılığıyla ödemeden sonraki saniyeler içinde güncellenir. İadelerde, mevcut bakiye ile sınırlı olmak üzere satın alınan krediler düşülür. Lemon Squeezy ile güvenli ödeme (KDV otomatik olarak işlenir).

Kod örnekleri

Kopyalayıp yapıştırın ve uyarlayın. API düz multipart/form-data konuşur, bu nedenle herhangi bir HTTP istemcisi işe yarar.

cURL

curl -sS -f -X POST https://api.pixel-to-path.com/v1/convert \
  -H "Authorization: Bearer ptp_live_YOUR_KEY" \
  -F "[email protected]" \
  -F "colormode=color" \
  -F "filter_speckle=4" \
  -o photo.svg

Python

import requests

resp = requests.post(
    "https://api.pixel-to-path.com/v1/convert",
    headers={"Authorization": "Bearer ptp_live_YOUR_KEY"},
    files={"file": open("photo.jpg", "rb")},
    data={"colormode": "color", "filter_speckle": 4},
)
resp.raise_for_status()
print(resp.headers["X-Credits-Remaining"], "credits left")
with open("photo.svg", "wb") as f:
    f.write(resp.content)

JavaScript

const form = new FormData();
form.append("file", new Blob([imageBytes]), "photo.jpg");
form.append("colormode", "color");

const resp = await fetch("https://api.pixel-to-path.com/v1/convert", {
  method: "POST",
  headers: { "Authorization": "Bearer ptp_live_YOUR_KEY" },
  body: form,
});
if (!resp.ok) {
  const { error } = await resp.json();
  throw new Error(`${error.code}: ${error.message}`);
}
const svg = await resp.text();
console.log(resp.headers.get("X-Credits-Remaining"), "credits left");

Sıkça Sorulan Sorular