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

تصدیق (Authentication)

ہر درخواست کی تصدیق Authorization ہیڈر میں ایک Bearer ٹوکن کے ساتھ کی جاتی ہے:

Authorization: Bearer ptp_live_0123abc…

• کلیدیں خفیہ ہوتی ہیں: انہیں سرور سائیڈ پر ہیش کر کے محفوظ کیا جاتا ہے اور تخلیق کے وقت صرف ایک بار دکھایا جاتا ہے۔ کلید کھو گئی؟ اسے منسوخ کریں اور ایک نئی بنائیں۔
• ایک اکاؤنٹ، متعدد کلیدیں: اپنے پروجیکٹس کو الگ کرنے کے لیے 5 تک فعال کلیدیں بنائیں۔ آپ کا ماہانہ مفت کوٹہ اکاؤنٹ کے لحاظ سے شمار کیا جاتا ہے، کلید کے لحاظ سے نہیں۔
• فوری منسوخی: منسوخ کی گئی کلید فوری طور پر کام کرنا بند کر دیتی ہے، چاہے پورٹل سے ہو یا بین (ban) شدہ اکاؤنٹ کے API ریسپانس سے۔

POST /v1/convert

ایک ہی اسٹیٹ لیس (stateless) کال میں اپ لوڈ + کنورژن۔ ایک کامیاب کال پر زیادہ سے زیادہ 1 کریڈٹ خرچ ہوتا ہے — ناکام، غلط یا ریٹ لمٹ شدہ کالز پر کچھ خرچ نہیں ہوتا۔

درخواست (multipart/form-data)

"colormode" کے ذریعے منتخب کردہ دو انجن

API بالکل وہی انجن چلاتی ہے جو مفت آن لائن کنورٹر اور ڈیسک ٹاپ ایپ میں ہیں:

تصاویر کو بالکل ویب سائٹ کی طرح پری پروسیس کیا جاتا ہے: تبادلوں سے پہلے سب سے لمبی سائیڈ کو 1500 px میں تبدیل کر دیا جاتا ہے، اور API X-Detected-Type ہیڈر میں تصویر کی شناخت شدہ قسم (line_art، logo، photo یا illustration) واپس کرتا ہے۔

ریسپانس

کامیابی پر: 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 }
}

غلطیاں (Errors)

ہر غلطی ایک مستقل JSON لفافہ (envelope) واپس کرتی ہے۔ ناکام کالز پر کبھی کریڈٹ خرچ نہیں ہوتا۔

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 کے بیچ میں)، حجم کی چھوٹ کے ساتھ۔ ان کی میعاد کبھی ختم نہیں ہوتی اور یہ آپ کے ماہانہ مفت کوٹے کے ساتھ اسٹیک ہوتے ہیں (مفت تبادلے پہلے استعمال ہوتے ہیں)۔

خودکار کریڈٹ: ادائیگی کے چند سیکنڈ کے اندر اندر آپ کا بیلنس ادائیگی کے ویب ہک کے ذریعے اپ ڈیٹ ہو جاتا ہے۔ رقم کی واپسی (Refunds) خریدے گئے کریڈٹس کو کم کرتی ہے، جو موجودہ بیلنس تک محدود ہوتی ہے۔ 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");

عمومی سوالات (FAQ)