PixelToPath API

クイックスタート

3つのステップで、ターミナル、スクリプト、またはアプリから画像を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).

認証

すべてのリクエストは、AuthorizationヘッダーにあるBearerトークンで認証されます:

Authorization: Bearer ptp_live_0123abc…

• キーは機密情報です: サーバー側でハッシュ化されて保存され、作成時に1度だけ表示されます。キーを紛失した場合は、無効化して新しいものを作成してください。
• 1つのアカウントで複数のキー: プロジェクトを分けるために、最大5つのアクティブなキーを作成できます。毎月の無料枠は、キーごとではなくアカウントごとにカウントされます。
• 即時無効化: 無効化されたキーは、ポータルから、またはアカウントがBANされた場合のAPIレスポンスから、直ちに機能しなくなります。

POST /v1/convert

単一のステートレスな呼び出しでアップロードと変換を行います。成功した呼び出しは最大1クレジットを消費しますが、失敗、無効、またはレート制限による呼び出しは一切クレジットを消費しません。

リクエスト (multipart/form-data)

"colormode"で選べる2つのエンジン

APIは、無料のオンラインコンバーターやデスクトップアプリと全く同じエンジンを実行します:

画像はウェブサイトと全く同じように前処理されます: 変換前に長辺が1500 pxにリサイズされ、APIは検出された画像タイプ (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 }
  }
}

レート制限

制限はIPごとではなくAPIキーごとに適用されるため、共有オフィスやCIランナーが他人のトラフィックのせいでペナルティを受けることはありません。

料金

すべての新しいアカウントには、クレジットカード不要で毎月10回の無料変換が付与されます。もっと必要ですか？プリペイド画像を購入できます — 任意の数量（50枚単位）で、ボリュームディスカウントもあります。有効期限はなく、毎月の無料枠とスタックします（無料の変換が先に消費されます）。

自動クレジット: 支払いのWebhookを介して、決済後数秒以内に残高が更新されます。払い戻しは購入したクレジットを差し引き、現在の残高が上限となります。Lemon Squeezyによる安全なチェックアウト（VATは自動的に処理されます）。

コード例

コピー＆ペーストして適応させてください。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");

よくある質問