PixelToPath API

Bắt đầu nhanh

Chỉ ba bước là bạn có thể chuyển đổi hình ảnh sang SVG từ thiết bị đầu cuối, tập lệnh hoặc ứng dụng của mình.

Chuyển đổi đầu tiên của bạn

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

Tài liệu tham khảo tương tác: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Xác thực

Mọi yêu cầu đều được xác thực bằng mã thông báo Bearer trong tiêu đề Authorization:

Authorization: Bearer ptp_live_0123abc…

• Khóa là bí mật: chúng được lưu trữ dưới dạng băm trên máy chủ và chỉ hiển thị một lần khi tạo. Mất khóa? Hãy thu hồi nó và tạo khóa mới.
• Một tài khoản, nhiều khóa: tạo tối đa 5 khóa đang hoạt động để phân chia các dự án của bạn. Hạn ngạch miễn phí hàng tháng được tính trên mỗi tài khoản, không phải trên mỗi khóa.
• Thu hồi ngay lập tức: khóa bị thu hồi sẽ ngừng hoạt động ngay lập tức, từ cổng thông tin hoặc phản hồi API của một tài khoản bị cấm.

POST /v1/convert

Tải lên + chuyển đổi trong một lệnh gọi không trạng thái duy nhất. Một lệnh gọi thành công tiêu tốn tối đa 1 tín dụng — các lệnh gọi thất bại, không hợp lệ hoặc bị giới hạn tốc độ sẽ không tính phí.

Yêu cầu (multipart/form-data)

Hai công cụ, được chọn bởi "colormode"

API chạy cùng một bộ công cụ giống hệt trình chuyển đổi miễn phí trực tuyến và ứng dụng dành cho máy tính để bàn:

Hình ảnh được tiền xử lý giống hệt như trên trang web: cạnh dài nhất được thay đổi kích thước thành 1500 px trước khi chuyển đổi và API sẽ trả về loại hình ảnh được phát hiện (line_art, logo, photo hoặc illustration) trong tiêu đề X-Detected-Type.

Phản hồi

Khi thành công: 200 OK với image/svg+xml — nội dung là chính tệp SVG. Các tiêu đề thông tin:

GET /v1/me

Trạng thái tài khoản của khóa được sử dụng để gọi. Miễn phí — không bao giờ tính vào hạn mức của bạn, không bao giờ bị trừ tín dụng.

Ví dụ về phản hồi

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 }
}

Lỗi

Mọi lỗi đều trả về một JSON đồng nhất. Các lệnh gọi thất bại sẽ không bao giờ tiêu tốn tín dụng.

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 }
  }
}

Giới hạn tốc độ

Các giới hạn được áp dụng trên mỗi khóa API, không phải trên mỗi IP, do đó một văn phòng dùng chung hoặc trình chạy CI sẽ không bao giờ bị phạt vì lưu lượng truy cập của người khác.

Bảng giá

Mọi tài khoản mới đều có 10 lượt chuyển đổi miễn phí mỗi tháng, không cần thẻ tín dụng. Cần thêm? Mua gói ảnh trả trước — với mọi số lượng (từng lô 50 ảnh), có giảm giá số lượng lớn. Chúng không bao giờ hết hạn và cộng dồn với hạn mức miễn phí hàng tháng của bạn (lượt chuyển đổi miễn phí sẽ được sử dụng trước).

Tín dụng tự động: số dư của bạn sẽ được cập nhật trong vài giây sau khi thanh toán, thông qua webhook thanh toán. Tiền hoàn lại sẽ khấu trừ tín dụng đã mua, giới hạn ở mức số dư hiện tại. Thanh toán an toàn bằng Lemon Squeezy (thuế GTGT được xử lý tự động).

Ví dụ về mã

Sao chép, dán và tùy chỉnh. API sử dụng định dạng multipart/form-data thuần túy, nên mọi máy khách HTTP đều hoạt động được.

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");

Những câu hỏi thường gặp