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).

प्रमाणीकरण

प्रत्येक अनुरोध को Authorization हेडर में एक Bearer टोकन के साथ प्रमाणित किया जाता है:

Authorization: Bearer ptp_live_0123abc…

• कुंजियाँ गुप्त हैं: उन्हें सर्वर-साइड पर हैश करके संग्रहीत किया जाता है और निर्माण के समय केवल एक बार प्रदर्शित किया जाता है। कुंजी खो गई? इसे रद्द करें और एक नई बनाएं।
• एक खाता, कई कुंजियाँ: अपने प्रोजेक्ट्स को अलग करने के लिए 5 सक्रिय कुंजियाँ तक बनाएँ। आपका मासिक मुफ़्त कोटा प्रति खाता गिना जाता है, प्रति कुंजी नहीं।
• तत्काल निरस्तीकरण: रद्द की गई कुंजी तुरंत काम करना बंद कर देती है, चाहे वह पोर्टल से हो या प्रतिबंधित खाते की API प्रतिक्रिया से।

POST /v1/convert

एक ही स्टेटलेस कॉल में अपलोड + रूपांतरण। एक सफल कॉल की कीमत अधिकतम 1 क्रेडिट होती है — विफल, अमान्य या दर-सीमित कॉल के लिए कोई कीमत नहीं लगती है।

अनुरोध (multipart/form-data)

दो इंजन, "colormode" द्वारा चुने गए

API बिल्कुल वही इंजन चलाती है जो मुफ़्त ऑनलाइन कनवर्टर और डेस्कटॉप ऐप चलाते हैं:

छवियों को बिल्कुल वेबसाइट की तरह प्रीप्रोसेस किया जाता है: कनवर्ट करने से पहले सबसे लंबे हिस्से का आकार 1500 px कर दिया जाता है, और API X-Detected-Type हेडर में पता लगाए गए छवि प्रकार (line_art, logo, photo या illustration) को लौटाता है।

प्रतिक्रिया

सफलता पर: 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 }
  }
}

दर सीमाएँ

सीमाएँ प्रति API कुंजी लागू होती हैं, प्रति IP नहीं, इसलिए साझा कार्यालय या 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");

अक्सर पूछे जाने वाले प्रश्न