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)

ทุกคำขอ (request) ต้องยืนยันตัวตนด้วย Bearer token ใน Authorization header:

Authorization: Bearer ptp_live_0123abc…

• คีย์คือความลับ: คีย์จะถูกจัดเก็บแบบแฮช (hashed) บนเซิร์ฟเวอร์ และแสดงเพียงครั้งเดียวเมื่อสร้าง หากทำคีย์หาย? ให้ยกเลิกและสร้างใหม่
• หนึ่งบัญชี, หลายคีย์: สร้างคีย์ที่ใช้งานได้สูงสุด 5 คีย์ เพื่อแยกการใช้งานในแต่ละโปรเจกต์ โควตาใช้งานฟรีรายเดือนของคุณจะนับรวมต่อบัญชี ไม่ใช่ต่อคีย์
• ยกเลิกได้ทันที: คีย์ที่ถูกยกเลิกจะหยุดทำงานทันที ไม่ว่าจะยกเลิกจากพอร์ทัล หรือเป็นการตอบสนองของ API ต่อบัญชีที่ถูกแบน

POST /v1/convert

อัปโหลด + แปลงไฟล์ในการเรียกแบบไร้สถานะ (stateless) เพียงครั้งเดียว การเรียกที่สำเร็จหนึ่งครั้งจะใช้เครดิตอย่างมากที่สุด 1 เครดิต — หากการเรียกล้มเหลว, ไม่ถูกต้อง หรือติดขีดจำกัดการใช้งาน (rate-limited) จะไม่เสียเครดิต

คำขอ (multipart/form-data)

สองเอนจิน เลือกโดย "colormode"

API รันด้วยเอนจินเดียวกันกับเครื่องมือแปลงไฟล์ออนไลน์ฟรีและแอปพลิเคชันบนเดสก์ท็อป:

รูปภาพจะถูกประมวลผลล่วงหน้า (preprocess) ในลักษณะเดียวกับบนเว็บไซต์: ด้านที่ยาวที่สุดจะถูกปรับขนาดเป็น 1500 px ก่อนการแปลง และ API จะคืนค่าประเภทของภาพที่ตรวจพบ (line_art, logo, photo หรือ illustration) ใน X-Detected-Type header

การตอบสนอง (Response)

เมื่อสำเร็จ: 200 OK พร้อมกับ image/svg+xml — โดยเนื้อหา (body) จะเป็นไฟล์ SVG ข้อมูลเพิ่มเติมใน header:

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 ในรูปแบบเดียวกันเสมอ การเรียกที่ล้มเหลวจะไม่มีการหักเครดิต

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 key ไม่ใช่ต่อ IP ดังนั้น การใช้งานร่วมกันในออฟฟิศ หรือ CI runner จะไม่ถูกจำกัดสิทธิ์จากการใช้งานของผู้อื่น

ราคา

บัญชีใหม่ทุกบัญชีจะได้รับสิทธิ์แปลงไฟล์ฟรี 10 ครั้งทุกเดือน ไม่ต้องใช้บัตรเครดิต หากต้องการใช้งานมากขึ้น? สามารถซื้อภาพแบบเติมเงิน — ในจำนวนใดก็ได้ (เป็นชุดละ 50 ภาพ) พร้อมส่วนลดเมื่อซื้อจำนวนมาก เครดิตไม่มีวันหมดอายุ และจะใช้ร่วมกับโควตาฟรีรายเดือนของคุณ (โดยจะใช้สิทธิ์แปลงไฟล์ฟรีให้หมดก่อนเสมอ)

เครดิตเข้าอัตโนมัติ: ยอดเงินคงเหลือของคุณจะได้รับการอัปเดตภายในไม่กี่วินาทีหลังจากการชำระเงินผ่าน payment webhook การขอคืนเงินจะถูกหักออกจากเครดิตที่ซื้อ โดยหักสูงสุดไม่เกินยอดเงินคงเหลือปัจจุบัน ชำระเงินอย่างปลอดภัยด้วย Lemon Squeezy (จัดการภาษีมูลค่าเพิ่มให้อัตโนมัติ)

ตัวอย่างโค้ด

คัดลอก-วาง และปรับแต่งตามต้องการ API รองรับรูปแบบ multipart/form-data ธรรมดา ดังนั้นสามารถใช้กับ HTTP client ใดก็ได้

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)