PixelToPath API

빠른 시작

단 3단계만으로 터미널, 스크립트 또는 앱에서 이미지를 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).

인증

모든 요청은 Authorization 헤더의 Bearer 토큰으로 인증됩니다:

Authorization: Bearer ptp_live_0123abc…

• 키는 비밀입니다: 서버 측에서 해시되어 저장되며 생성 시 한 번만 표시됩니다. 키를 분실하셨나요? 키를 취소하고 새로 생성하세요.
• 하나의 계정, 여러 개의 키: 최대 5개의 활성 키를 생성하여 프로젝트를 분리할 수 있습니다. 월별 무료 할당량은 키가 아닌 계정당 계산됩니다.
• 즉각적인 취소: 취소된 키는 포털에서 또는 차단된 계정의 API 응답에서 즉시 작동을 멈춥니다.

POST /v1/convert

단일 상태 비저장 호출로 업로드와 변환을 수행합니다. 성공한 호출은 최대 1 크레딧을 소비하며 실패, 유효하지 않은 또는 속도 제한에 걸린 호출은 비용이 발생하지 않습니다.

요청 (multipart/form-data)

"colormode"에 따라 선택되는 두 가지 엔진

API는 무료 온라인 변환기 및 데스크톱 앱과 완전히 동일한 엔진을 실행합니다:

이미지는 웹사이트와 정확히 동일하게 전처리됩니다. 변환 전에 가장 긴 면이 1500px로 크기 조정되며, API는 감지된 이미지 유형(line_art, logo, photo 또는 illustration)을 X-Detected-Type 헤더로 반환합니다.

응답

성공 시: image/svg+xml과 함께 200 OK — 본문은 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 }
  }
}

속도 제한

제한은 IP가 아닌 API 키당 적용되므로, 공유 사무실이나 CI 러너는 다른 사람의 트래픽으로 인해 불이익을 받지 않습니다.

가격

모든 신규 계정은 신용카드 없이 매월 10회의 무료 변환을 받습니다. 더 필요하신가요? 선불 이미지를 대량 할인과 함께 50개 단위로 원하는 만큼 구매하세요. 만료되지 않으며 월별 무료 할당량과 함께 중첩됩니다 (무료 변환이 먼저 소진됩니다).

자동 크레딧 충전: 잔액은 결제 웹훅을 통해 결제 후 몇 초 내에 업데이트됩니다. 환불 시 구매한 크레딧이 차감되며, 현재 잔액까지만 차감됩니다. Lemon Squeezy를 통한 안전한 결제(VAT 자동 처리).

코드 예시

복사하여 붙여넣고 조정하세요. 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");

자주 묻는 질문