PixelToPath API

Quickstart

Three steps and you are converting images to SVG from your terminal, your scripts or your app.

Your first conversion

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

Interactive reference: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Authentication

Every request is authenticated with a Bearer token in the Authorization header:

Authorization: Bearer ptp_live_0123abc…

• Keys are secrets: they are stored hashed server-side and displayed only once at creation. Lost key? Revoke it and create a new one.
• One account, several keys: create up to 5 active keys to separate your projects. Your monthly free quota is counted per account, not per key.
• Instant revocation: a revoked key stops working immediately, from the portal or the API response of a banned account.

POST /v1/convert

Upload + conversion in a single stateless call. One successful call costs at most 1 credit — failed, invalid or rate-limited calls cost nothing.

Request (multipart/form-data)

Two engines, chosen by "colormode"

The API runs the exact same engines as the free online converter and the desktop app:

Images are preprocessed exactly like on the website: the longest side is resized to 1500 px before conversion, and the API returns the detected image type (line_art, logo, photo or illustration) in the X-Detected-Type header.

Response

On success: 200 OK with image/svg+xml — the body is the SVG file itself. Informative headers:

GET /v1/me

Account status for the key used to call it. Free — never counted against your quota, never debited.

Example response

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

Errors

Every error returns a consistent JSON envelope. Failed calls never consume 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 }
  }
}

Rate limits

Limits apply per API key, not per IP, so a shared office or CI runner is never penalized for someone else's traffic.

Pricing

Every new account gets 10 free conversions every month, no credit card required. Need more? Buy prepaid images — any quantity (in batches of 50), with volume discounts. They never expire and stack with your monthly free quota (free conversions are consumed first).

Automatic credit: your balance is updated within seconds of the payment, via the payment webhook. Refunds deduct the purchased credits, capped at the current balance. Secure checkout by Lemon Squeezy (VAT handled automatically).

Code examples

Copy-paste and adapt. The API speaks plain multipart/form-data, so any HTTP client works.

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

Frequently asked questions