API PixelToPath

Швидкий старт

Три кроки — і ви зможете конвертувати зображення в SVG з терміналу, скриптів або свого застосунку.

Ваша перша конвертація

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

Інтерактивна довідка: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Аутентифікація

Кожен запит аутентифікується за допомогою Bearer-токена в заголовку Authorization:

Authorization: Bearer ptp_live_0123abc…

• Ключі — це секретні дані: вони зберігаються на сервері у хешованому вигляді і відображаються лише один раз під час створення. Втратили ключ? Відкличте його і створіть новий.
• Один акаунт, кілька ключів: ви можете створити до 5 активних ключів для розділення своїх проєктів. Безкоштовний ліміт рахується на акаунт, а не на кожен ключ.
• Миттєве відкликання: відкликаний ключ перестає працювати відразу. Це також стосується заблокованих акаунтів.

POST /v1/convert

Завантаження та конвертація за один stateless-виклик (без збереження стану). Успішний запит знімає максимум 1 кредит. За невдалі, невалідні або відхилені через перевищення ліміту виклики кредити не знімаються.

Запит (multipart/form-data)

Два рушії, що обираються за допомогою "colormode"

API використовує ті самі рушії, що й безкоштовний онлайн-конвертер або десктопний додаток:

Зображення попередньо обробляються так само, як і на вебсайті: найдовша сторона зменшується до 1500 пкс перед конвертацією, а API повертає виявлений тип зображення (line_art, logo, photo або illustration) у заголовку X-Detected-Type.

Відповідь

У разі успіху: 200 OK з image/svg+xml — саме тіло (body) є файлом SVG. Інформативні заголовки:

GET /v1/me

Статус акаунта для ключа, використаного для виклику. Безкоштовно — ніколи не враховується в квоті і не списує кредити.

Приклад відповіді

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

Помилки

Кожна помилка повертається в єдиному JSON-форматі. За невдалі виклики кредити ніколи не списуються.

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)

Обмеження діють на кожен API-ключ, а не на IP-адресу. Тому спільний офіс або CI-сервер ніколи не постраждають від чужого трафіку.

Ціни

Кожен новий акаунт отримує 10 безкоштовних конвертацій щомісяця, кредитна картка не потрібна. Потрібно більше? Купуйте передплачені зображення — будь-яку кількість (пакетами по 50 шт.) зі знижкою за об’єм. Вони ніколи не згорають і сумуються з безкоштовним місячним лімітом (спершу списуються безкоштовні).

Автоматичне поповнення: баланс оновлюється через кілька секунд після оплати за допомогою webhook'у. Повернення коштів списує куплені кредити, обмежені поточним балансом. Безпечне оформлення замовлення через Lemon Squeezy (ПДВ обчислюється автоматично).

Приклади коду

Скопіюйте та адаптуйте під свої потреби. API працює зі звичайним multipart/form-data, тому підійде будь-який HTTP-клієнт.

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

Часті запитання (FAQ)