PixelToPath API

Snel aan de slag

Drie stappen en je converteert afbeeldingen naar SVG vanuit je terminal, je scripts of je app.

Je eerste conversie

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

Interactieve referentie: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Authenticatie

Elk verzoek wordt geauthenticeerd met een Bearer-token in de Authorization header:

Authorization: Bearer ptp_live_0123abc…

• Sleutels zijn geheimen: ze worden gehasht opgeslagen op de server en slechts één keer getoond bij creatie. Sleutel kwijt? Trek hem in en maak een nieuwe aan.
• Eén account, meerdere sleutels: maak tot 5 actieve sleutels aan om je projecten te scheiden. Je maandelijkse gratis quotum wordt per account geteld, niet per sleutel.
• Directe intrekking: een ingetrokken sleutel stopt onmiddellijk met werken, vanuit het portaal of de API-respons van een verbannen account.

POST /v1/convert

Uploaden + conversie in een enkele stateless call. Eén succesvolle call kost maximaal 1 credit — mislukte, ongeldige of snelheidsbeperkte (rate-limited) calls kosten niets.

Verzoek (multipart/form-data)

Twee engines, gekozen door "colormode"

De API draait precies dezelfde engines als de gratis online converter en de desktop-app:

Afbeeldingen worden precies zo voorbewerkt als op de website: de langste zijde wordt voor de conversie verkleind naar 1500 px, en de API retourneert het gedetecteerde afbeeldingstype (line_art, logo, photo of illustration) in de X-Detected-Type header.

Respons

Bij succes: 200 OK met image/svg+xml — de body is het SVG-bestand zelf. Informatieve headers:

GET /v1/me

Accountstatus voor de sleutel die gebruikt is om het aan te roepen. Gratis — wordt nooit meegeteld voor je quotum, wordt nooit in rekening gebracht.

Voorbeeldrespons

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

Fouten

Elke fout retourneert een consistente JSON-envelop. Mislukte calls verbruiken nooit credits.

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

Snelheidslimieten

Limieten gelden per API-sleutel, niet per IP, dus een gedeeld kantoor of CI-runner wordt nooit benadeeld door het verkeer van iemand anders.

Prijzen

Elk nieuw account krijgt 10 gratis conversies elke maand, geen creditcard vereist. Heb je meer nodig? Koop prepaid afbeeldingen — elke hoeveelheid (in bundels van 50), met volumekortingen. Ze vervallen nooit en stapelen op met je maandelijkse gratis quotum (gratis conversies worden eerst verbruikt).

Automatisch tegoed: je saldo wordt binnen enkele seconden na de betaling bijgewerkt, via de betalingswebhook. Terugbetalingen verminderen de gekochte credits, gemaximeerd op het huidige saldo. Veilig afrekenen via Lemon Squeezy (btw wordt automatisch verwerkt).

Codevoorbeelden

Kopieer, plak en pas aan. De API spreekt plain multipart/form-data, dus elke HTTP-client werkt.

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

Veelgestelde vragen