API PixelToPath

Szybki start

Tylko trzy kroki dzielą Cię od konwersji obrazów na SVG z Twojego terminala, skryptu lub aplikacji.

Twoja pierwsza konwersja

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

Interaktywna dokumentacja: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Uwierzytelnianie

Każde żądanie jest uwierzytelniane za pomocą tokena Bearer w nagłówku Authorization:

Authorization: Bearer ptp_live_0123abc…

• Klucze są tajne: są przechowywane na serwerze w formie zaszyfrowanej i wyświetlane tylko raz przy tworzeniu. Zgubiłeś klucz? Unieważnij go i stwórz nowy.
• Jedno konto, kilka kluczy: utwórz do 5 aktywnych kluczy, aby oddzielić różne projekty. Twój miesięczny darmowy limit jest liczony na całe konto, a nie na pojedynczy klucz.
• Natychmiastowe unieważnienie: unieważniony klucz natychmiast przestaje działać, zarówno z poziomu portalu, jak i w odpowiedziach API dla zbanowanego konta.

POST /v1/convert

Przesłanie pliku i konwersja podczas jednego bezstanowego wywołania. Jedno udane wywołanie kosztuje najwyżej 1 kredyt — nieudane, nieprawidłowe lub zablokowane z powodu limitu wywołania są darmowe.

Żądanie (multipart/form-data)

Dwa silniki, wybierane przez "colormode"

API używa dokładnie tych samych silników, co darmowy konwerter online i aplikacja desktopowa:

Obrazy są wstępnie przetwarzane dokładnie tak, jak na stronie internetowej: najdłuższy bok jest zmniejszany do 1500 pikseli przed konwersją, a API zwraca wykryty typ obrazu (line_art, logo, photo lub illustration) w nagłówku X-Detected-Type.

Odpowiedź

W przypadku sukcesu: 200 OK z image/svg+xml — sama odpowiedź zawiera plik SVG. Informacyjne nagłówki:

GET /v1/me

Status konta dla klucza, który wykonał wywołanie. Bezpłatne — nigdy nie jest odejmowane z puli kredytów ani limitów.

Przykładowa odpowiedź

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

Błędy

Każdy błąd zwraca spójną strukturę JSON. Nieudane wywołania nigdy nie pobierają kredytów.

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

Limity wywołań

Limity są stosowane na poziomie klucza API, nie na adres IP. Dzięki temu współdzielone biuro czy narzędzia CI nigdy nie są blokowane przez ruch innej osoby.

Cennik

Każde nowe konto otrzymuje 10 darmowych konwersji każdego miesiąca, nie wymagamy podania karty kredytowej. Potrzebujesz więcej? Kup pakiety przedpłacone na obrazy — dowolną ilość (w pakietach po 50), ze zniżkami ilościowymi. Nigdy nie wygasają i łączą się z miesięcznym, darmowym limitem (darmowe konwersje są zużywane jako pierwsze).

Automatyczne doładowanie: Twoje saldo zostanie zaktualizowane w ciągu kilku sekund po dokonaniu płatności, za pomocą webhooka. Zwroty pieniędzy odliczają kupione kredyty, maksymalnie do aktualnego salda konta. Bezpieczne płatności obsługuje Lemon Squeezy (podatek VAT obliczany automatycznie).

Przykłady kodu

Skopiuj, wklej i dopasuj. API korzysta z formatu multipart/form-data, więc można go używać z dowolnym klientem HTTP.

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");

Często zadawane pytania