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 активных ключей для разделения ваших проектов. Бесплатная месячная квота рассчитывается на аккаунт, а не на ключ.
• Мгновенный отзыв: отозванный ключ перестает работать немедленно, будь то через отзыв на портале или через API-ответ для заблокированного аккаунта.

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 — тело ответа является самим файлом 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 }
  }
}

Лимиты запросов

Лимиты применяются к ключу API, а не к IP, поэтому общий офис или CI runner никогда не будут наказаны за чужой трафик.

Цены

Каждый новый аккаунт получает 10 бесплатных конвертаций в месяц, кредитная карта не требуется. Нужно больше? Покупайте предоплаченные изображения — в любом количестве (партиями по 50), со скидками за объем. Они никогда не сгорают и суммируются с вашей бесплатной месячной квотой (бесплатные конвертации расходуются в первую очередь).

Автоматическое начисление кредитов: ваш баланс обновляется в течение нескольких секунд после оплаты через платежный вебхук. При возврате средств списываются купленные кредиты, но не более текущего баланса. Безопасное оформление заказа через 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");

Часто задаваемые вопросы