PixelToPath API

Mulai Cepat

Tiga langkah dan Anda sudah mengonversi gambar ke SVG dari terminal, skrip, atau aplikasi Anda.

Konversi pertama Anda

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

Referensi interaktif: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Autentikasi

Setiap permintaan diautentikasi dengan token Bearer di header Authorization:

Authorization: Bearer ptp_live_0123abc…

• Kunci adalah rahasia: kunci disimpan dalam bentuk hash di sisi server dan hanya ditampilkan sekali saat pembuatan. Kunci hilang? Cabut dan buat yang baru.
• Satu akun, beberapa kunci: buat hingga 5 kunci aktif untuk memisahkan proyek Anda. Kuota gratis bulanan Anda dihitung per akun, bukan per kunci.
• Pencabutan instan: kunci yang dicabut akan langsung berhenti berfungsi, dari portal atau respons API pada akun yang diblokir.

POST /v1/convert

Unggah + konversi dalam satu panggilan tanpa status (stateless). Satu panggilan yang berhasil paling banyak membutuhkan 1 kredit — panggilan yang gagal, tidak valid, atau terkena batas laju tidak memakan biaya.

Permintaan (multipart/form-data)

Dua mesin, dipilih dengan "colormode"

API menjalankan mesin yang sama persis dengan konverter online gratis dan aplikasi desktop:

Gambar diproses persis seperti di situs web: sisi terpanjang diubah ukurannya menjadi 1500 px sebelum konversi, dan API mengembalikan tipe gambar yang terdeteksi (line_art, logo, photo, atau illustration) di header X-Detected-Type.

Respons

Saat berhasil: 200 OK dengan image/svg+xml — badan respons adalah file SVG itu sendiri. Header informatif:

GET /v1/me

Status akun untuk kunci yang digunakan untuk memanggilnya. Gratis — tidak pernah dihitung dalam kuota Anda, tidak pernah dipotong.

Contoh respons

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

Kesalahan

Setiap kesalahan mengembalikan struktur (envelope) JSON yang konsisten. Panggilan yang gagal tidak pernah menggunakan kredit.

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

Batas laju

Batasan berlaku per kunci API, bukan per IP, sehingga kantor atau CI runner yang berbagi koneksi tidak pernah dihukum karena lalu lintas orang lain.

Harga

Setiap akun baru mendapatkan 10 konversi gratis setiap bulan, tidak memerlukan kartu kredit. Butuh lebih banyak? Beli gambar prabayar — jumlah berapa pun (dalam kelipatan 50), dengan diskon volume. Kredit tidak pernah kedaluwarsa dan ditumpuk dengan kuota gratis bulanan Anda (konversi gratis digunakan terlebih dahulu).

Kredit otomatis: saldo Anda diperbarui dalam hitungan detik setelah pembayaran, melalui webhook pembayaran. Pengembalian dana memotong kredit yang dibeli, dibatasi hingga saldo saat ini. Pembayaran aman oleh Lemon Squeezy (PPN ditangani secara otomatis).

Contoh kode

Salin-tempel dan sesuaikan. API menggunakan multipart/form-data biasa, sehingga klien HTTP apa pun dapat digunakan.

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

Pertanyaan yang sering diajukan