PixelToPath API

Snabbstart

Tre steg och du konverterar bilder till SVG från din terminal, dina skript eller din app.

Din första konvertering

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

Interaktiv referens: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Autentisering

Varje begäran autentiseras med en Bearer-token i Authorization-huvudet:

Authorization: Bearer ptp_live_0123abc…

• Nycklar är hemligheter: de lagras hashade på serversidan och visas bara en gång vid skapandet. Tappat bort nyckeln? Återkalla den och skapa en ny.
• Ett konto, flera nycklar: skapa upp till 5 aktiva nycklar för att separera dina projekt. Din månatliga gratiskvot räknas per konto, inte per nyckel.
• Omedelbar återkallelse: en återkallad nyckel slutar fungera omedelbart, från portalen eller API-svaret för ett bannlyst konto.

POST /v1/convert

Uppladdning + konvertering i ett enda tillståndslöst anrop. Ett framgångsrikt anrop kostar högst 1 kredit — misslyckade, ogiltiga eller hastighetsbegränsade anrop kostar ingenting.

Begäran (multipart/form-data)

Två motorer, valda av "colormode"

API:et kör exakt samma motorer som den kostnadsfria onlinekonverteraren och skrivbordsappen:

Bilder förbehandlas exakt som på webbplatsen: den längsta sidan ändras till 1500 px före konvertering, och API:et returnerar den upptäckta bildtypen (line_art, logo, photo eller illustration) i huvudet X-Detected-Type.

Svar

Vid framgång: 200 OK med image/svg+xml — kroppen är själva SVG-filen. Informativa huvuden:

GET /v1/me

Kontostatus för nyckeln som användes för att anropa den. Gratis — räknas aldrig mot din kvot, debiteras aldrig.

Exempelsvar

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

Fel

Varje fel returnerar ett konsekvent JSON-hölje. Misslyckade anrop förbrukar aldrig krediter.

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

Hastighetsgränser

Gränser gäller per API-nyckel, inte per IP, så ett delat kontor eller en CI-körare straffas aldrig för någon annans trafik.

Priser

Varje nytt konto får 10 gratis konverteringar varje månad, inget kreditkort krävs. Behöver du mer? Köp förbetalda bilder — vilken mängd som helst (i partier om 50), med volymrabatter. De går aldrig ut och staplas med din månatliga gratiskvot (gratis konverteringar förbrukas först).

Automatisk kreditering: ditt saldo uppdateras inom några sekunder efter betalningen via betalningens webhook. Återbetalningar drar av de köpta krediterna, maximerat till det aktuella saldot. Säker betalning med Lemon Squeezy (moms hanteras automatiskt).

Kodexempel

Kopiera, klistra in och anpassa. API:et talar vanlig multipart/form-data, så vilken HTTP-klient som helst fungerar.

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

Vanliga frågor