PixelToPath API

התחלה מהירה

שלושה צעדים ואתם ממירים תמונות ל-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…

• מפתחות הם סודות: הם נשמרים מוצפנים (hash) בשרת ומוצגים רק פעם אחת ביצירה. איבדתם מפתח? שללו אותו וצרו חדש.
• חשבון אחד, כמה מפתחות: צרו עד 5 מפתחות פעילים להפרדת הפרויקטים שלכם. מכסת החינם החודשית נספרת לחשבון, לא למפתח.
• שלילה מיידית: מפתח שנשלל מפסיק לעבוד מיד, מהפורטל או מתגובת ה-API של חשבון חסום.

POST /v1/convert

העלאה + המרה בקריאה אחת חסרת מצב. כל קריאה מוצלחת עולה לכל היותר קרדיט 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 }
  }
}

הגבלות קצב

ההגבלות חלות למפתח ולא לכתובת 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");

שאלות נפוצות