API PixelToPath

Rychlý start

Ve třech krocích převedete obrázky do SVG z vašeho terminálu, skriptů nebo aplikace.

Vaše první konverze

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

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

Ověřování

Každý požadavek je ověřen pomocí Bearer tokenu v hlavičce Authorization:

Authorization: Bearer ptp_live_0123abc…

• Klíče jsou tajné: jsou uloženy na serveru zahašované a zobrazí se pouze jednou při vytvoření. Ztratili jste klíč? Odvolejte ho a vytvořte si nový.
• Jeden účet, více klíčů: vytvořte si až 5 aktivních klíčů pro oddělení vašich projektů. Vaše měsíční bezplatná kvóta se počítá na účet, ne na klíč.
• Okamžité odvolání: odvolaný klíč okamžitě přestane fungovat, ať už z portálu nebo prostřednictvím odpovědi API zablokovaného účtu.

POST /v1/convert

Nahrání a konverze v jednom bezstavovém volání. Úspěšné volání stojí maximálně 1 kredit — neúspěšná volání, neplatná volání nebo volání omezená limitem požadavků nestojí nic.

Požadavek (multipart/form-data)

Dva enginy, vybrané pomocí "colormode"

API spouští přesně stejné enginy jako bezplatný online převodník a desktopová aplikace:

Obrázky jsou předzpracovány přesně tak, jak na webu: nejdelší strana je před konverzí změněna na 1500 px a API vrací zjištěný typ obrázku (line_art, logo, photo nebo illustration) v hlavičce X-Detected-Type.

Odpověď

Při úspěchu: 200 OK s image/svg+xml — tělem odpovědi je samotný soubor SVG. Informační hlavičky:

GET /v1/me

Stav účtu pro klíč použitý při volání. Zdarma — nikdy se neodečítá z vaší kvóty, nikdy se neúčtuje.

Příklad odpovědi

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

Chyby

Každá chyba vrací konzistentní JSON objekt. Neúspěšná volání nikdy nespotřebují kredity.

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 požadavků

Limity se vztahují na API klíč, nikoli na IP adresu, takže sdílená kancelář nebo CI agent nebude nikdy penalizován provozem někoho jiného.

Ceník

Každý nový účet získává 10 konverzí zdarma každý měsíc, bez kreditní karty. Potřebujete více? Kupte si předplacené obrázky — libovolné množství (v balíčcích po 50), s množstevními slevami. Nikdy nevyprší a sčítají se s vaší měsíční bezplatnou kvótou (bezplatné konverze se spotřebují jako první).

Automatické připsání: váš zůstatek se aktualizuje během několika sekund po zaplacení, prostřednictvím platebního webhooku. Vrácení peněz odečítá zakoupené kredity, v rámci aktuálního zůstatku. Bezpečná platba přes Lemon Squeezy (DPH je spravována automaticky).

Příklady kódu

Zkopírujte a upravte. API používá standardní multipart/form-data, takže funguje jakýkoli HTTP klient.

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

Často kladené otázky