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…

• কি (keys) হলো গোপনীয়: এগুলি সার্ভার-সাইডে হ্যাশ করে সংরক্ষিত থাকে এবং তৈরি করার সময় শুধুমাত্র একবারই দেখানো হয়। কি হারিয়ে গেছে? এটি প্রত্যাহার করুন এবং একটি নতুন কি তৈরি করুন।
• এক অ্যাকাউন্ট, একাধিক কি: আপনার প্রোজেক্টগুলিকে আলাদা রাখতে ৫টি পর্যন্ত সক্রিয় কি তৈরি করুন। আপনার মাসিক ফ্রি কোটা প্রতি অ্যাকাউন্টের ভিত্তিতে গণনা করা হয়, প্রতি কি-এর ভিত্তিতে নয়।
• তাত্ক্ষণিক প্রত্যাহার: একটি প্রত্যাহার করা কি অবিলম্বে কাজ করা বন্ধ করে দেয়, তা পোর্টাল থেকেই হোক বা নিষিদ্ধ অ্যাকাউন্টের API রেসপন্স থেকে।

POST /v1/convert

একটি একক স্টেটলেস কলে আপলোড + রূপান্তর। একটি সফল কলে সর্বাধিক ১টি ক্রেডিট খরচ হয় — ব্যর্থ, অবৈধ বা রেট-লিমিটেড কলে কোনো খরচ হয় না।

রিকোয়েস্ট (multipart/form-data)

দুটি ইঞ্জিন, "colormode" দ্বারা নির্বাচিত

API বিনামূল্যে অনলাইন কনভার্টার এবং ডেস্কটপ অ্যাপের মতো একই ইঞ্জিন চালায়:

ছবিগুলি ঠিক ওয়েবসাইটের মতোই প্রি-প্রসেস করা হয়: রূপান্তরের আগে দীর্ঘতম দিকটিকে ১৫০০ px-এ রিসাইজ করা হয়, এবং API X-Detected-Type হেডারে শনাক্ত করা ছবির টাইপ (line_art, logo, photo বা illustration) প্রদান করে।

রেসপন্স

সফল হলে: 200 OK সাথে image/svg+xml — বডিতে থাকে আসল SVG ফাইলটি। তথ্যমূলক হেডারগুলি:

GET /v1/me

এটি কল করতে ব্যবহৃত কি (key)-এর অ্যাকাউন্টের অবস্থা। বিনামূল্যে — কখনো আপনার কোটা থেকে গণনা করা হয় না, কখনো চার্জ করা হয় না।

উদাহরণ রেসপন্স

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 এনভেলপ প্রদান করে। ব্যর্থ কলগুলিতে কখনো ক্রেডিট খরচ হয় না।

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 রানার কখনো শাস্তি পাবে না।

মূল্য (Pricing)

প্রতিটি নতুন অ্যাকাউন্ট প্রতি মাসে ১০টি ফ্রি রূপান্তর পায়, কোনো ক্রেডিট কার্ডের প্রয়োজন নেই। আরও প্রয়োজন? প্রিপেইড ছবি কিনুন — যেকোনো পরিমাণ (৫০-এর ব্যাচে), ভলিউম ডিসকাউন্ট সহ। এগুলোর মেয়াদ কখনো শেষ হয় না এবং আপনার মাসিক ফ্রি কোটার সাথে যুক্ত হয় (আগে ফ্রি রূপান্তরগুলি ব্যবহৃত হয়)।

স্বয়ংক্রিয় ক্রেডিট: পেমেন্ট ওয়েবহুকের মাধ্যমে পেমেন্টের কয়েক সেকেন্ডের মধ্যে আপনার ব্যালেন্স আপডেট হয়। রিফান্ড করলে কেনা ক্রেডিট কেটে নেওয়া হয়, যা বর্তমান ব্যালেন্স পর্যন্ত সীমিত। 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");

প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী (FAQ)