PixelToPath API

Schnellstart

Drei Schritte, und Sie können Bilder über Ihr Terminal, Ihre Skripte oder Ihre App in SVGs umwandeln.

Ihre erste Konvertierung

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

Interaktive Referenz: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Authentifizierung

Jede Anfrage wird mit einem Bearer-Token im Authorization-Header authentifiziert:

Authorization: Bearer ptp_live_0123abc…

• Schlüssel sind geheim: Sie werden serverseitig gehasht gespeichert und nur einmal bei der Erstellung angezeigt. Schlüssel verloren? Widerrufen Sie ihn und erstellen Sie einen neuen.
• Ein Konto, mehrere Schlüssel: Erstellen Sie bis zu 5 aktive Schlüssel, um Ihre Projekte zu trennen. Ihr monatliches Freikontingent wird pro Konto abgerechnet, nicht pro Schlüssel.
• Sofortiger Widerruf: Ein widerrufener Schlüssel funktioniert sofort nicht mehr, weder vom Portal aus noch bei API-Anfragen eines gesperrten Kontos.

POST /v1/convert

Upload + Konvertierung in einem einzigen zustandslosen Aufruf. Ein erfolgreicher Aufruf kostet maximal 1 Credit — fehlgeschlagene, ungültige oder durch das Ratenlimit blockierte Aufrufe kosten nichts.

Anfrage (multipart/form-data)

Zwei Engines, gesteuert über "colormode"

Die API führt exakt dieselben Engines aus wie der kostenlose Online-Konverter und die Desktop-App:

Bilder werden genau wie auf der Website vorverarbeitet: Die längste Seite wird vor der Konvertierung auf 1500 px skaliert, und die API gibt den erkannten Bildtyp (line_art, logo, photo oder illustration) im Header X-Detected-Type zurück.

Antwort

Bei Erfolg: 200 OK mit image/svg+xml — der Body ist die SVG-Datei selbst. Informative Header:

GET /v1/me

Kontostatus für den verwendeten Schlüssel. Kostenlos — wird nie auf Ihr Kontingent angerechnet oder abgebucht.

Beispielantwort

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

Fehler

Jeder Fehler liefert eine einheitliche JSON-Struktur zurück. Fehlgeschlagene Aufrufe verbrauchen keine 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 }
  }
}

Ratenlimits

Limits gelten pro API-Schlüssel, nicht pro IP. So wird ein gemeinsames Büro oder ein CI-Runner nie für den Datenverkehr anderer bestraft.

Preise

Jedes neue Konto erhält jeden Monat 10 kostenlose Konvertierungen, ohne dass eine Kreditkarte erforderlich ist. Brauchen Sie mehr? Kaufen Sie Prepaid-Bilder — in beliebiger Menge (in 50er-Schritten) mit Mengenrabatten. Sie verfallen nie und sind mit Ihrem monatlichen Freikontingent kombinierbar (kostenlose Konvertierungen werden zuerst verbraucht).

Automatische Gutschrift: Ihr Guthaben wird innerhalb von Sekunden nach der Zahlung per Webhook aktualisiert. Bei Rückerstattungen werden die gekauften Credits bis maximal zum aktuellen Guthaben abgezogen. Sicherer Checkout über Lemon Squeezy (MwSt. wird automatisch berechnet).

Code-Beispiele

Kopieren, einfügen und anpassen. Die API spricht reines multipart/form-data, sodass jeder HTTP-Client funktioniert.

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

Häufig gestellte Fragen