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…

• المفاتيح أسرار: يتم تخزينها مجزأة من جانب الخادم وتُعرض مرة واحدة فقط عند الإنشاء. هل فقدت مفتاحك؟ قم بإبطاله وأنشئ واحدًا جديدًا.
• حساب واحد، مفاتيح متعددة: أنشئ حتى 5 مفاتيح نشطة لفصل مشاريعك. يتم حساب حصتك المجانية الشهرية لكل حساب، وليس لكل مفتاح.
• إبطال فوري: يتوقف المفتاح المُبطل عن العمل فورًا، من البوابة أو من استجابة API لحساب محظور.

POST /v1/convert

رفع + تحويل في استدعاء واحد عديم الحالة (stateless). الاستدعاء الناجح يكلف رصيدًا واحدًا على الأكثر — الاستدعاءات الفاشلة أو غير الصالحة أو المحدودة المعدل لا تكلف شيئًا.

الطلب (multipart/form-data)

محركان، يتم اختيارهما بواسطة "colormode"

تشغل واجهة برمجة التطبيقات نفس المحركات تمامًا مثل المحول المجاني عبر الإنترنت وتطبيق سطح المكتب:

تتم معالجة الصور مسبقًا تمامًا كما هو الحال في الموقع: يتم تغيير حجم الجانب الأطول إلى 1500 بكسل قبل التحويل، وتُرجع واجهة برمجة التطبيقات نوع الصورة المكتشف (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 }
  }
}

حدود المعدل

تُطبق الحدود لكل مفتاح API، وليس لكل IP، لذلك لا يتم معاقبة مكتب مشترك أو مشغل CI أبدًا بسبب حركة مرور شخص آخر.

التسعير

يحصل كل حساب جديد على 10 تحويلات مجانية كل شهر، ولا يتطلب بطاقة ائتمان. هل تحتاج إلى المزيد؟ اشترِ صورًا مسبقة الدفع — أي كمية (في دفعات من 50)، مع خصومات على الكمية. لا تنتهي صلاحيتها أبدًا وتتراكم مع حصتك المجانية الشهرية (يتم استهلاك التحويلات المجانية أولاً).

إضافة رصيد تلقائي: يتم تحديث رصيدك في غضون ثوانٍ من الدفع، عبر خطاف الدفع (webhook). تقوم المبالغ المستردة بخصم الأرصدة المشتراة، وبحد أقصى للرصيد الحالي. إتمام دفع آمن عبر Lemon Squeezy (يتم التعامل مع ضريبة القيمة المضافة تلقائيًا).

أمثلة برمجية

انسخ والصق وقم بالتعديل. تتحدث واجهة برمجة التطبيقات بصيغة 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");

الأسئلة الشائعة