API PixelToPath

Démarrage rapide

En trois étapes, vous convertirez des images en SVG depuis votre terminal, vos scripts ou votre application.

Votre première conversion

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

Référence interactive : pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Authentification

Chaque requête est authentifiée avec un jeton Bearer dans l'en-tête Authorization :

Authorization: Bearer ptp_live_0123abc…

• Les clés sont secrètes : elles sont stockées hachées côté serveur et ne sont affichées qu'une seule fois à la création. Clé perdue ? Révoquez-la et créez-en une nouvelle.
• Un compte, plusieurs clés : créez jusqu'à 5 clés actives pour séparer vos projets. Votre quota gratuit mensuel est calculé par compte, non par clé.
• Révocation instantanée : une clé révoquée cesse immédiatement de fonctionner, que ce soit depuis le portail ou via la réponse de l'API d'un compte banni.

POST /v1/convert

Téléversement et conversion en un seul appel sans état. Un appel réussi coûte au maximum 1 crédit — les appels échoués, invalides ou limités par le taux de requêtes ne coûtent rien.

Requête (multipart/form-data)

Deux moteurs, choisis par "colormode"

L'API exécute exactement les mêmes moteurs que le convertisseur en ligne gratuit et l'application de bureau :

Les images sont prétraitées exactement comme sur le site web : le côté le plus long est redimensionné à 1500 px avant la conversion, et l'API renvoie le type d'image détecté (line_art, logo, photo ou illustration) dans l'en-tête X-Detected-Type.

Réponse

En cas de succès : 200 OK avec image/svg+xml — le corps de la réponse est le fichier SVG lui-même. En-têtes informatifs :

GET /v1/me

Statut du compte pour la clé utilisée lors de l'appel. Gratuit — n'est jamais décompté de votre quota, jamais débité.

Exemple de réponse

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

Erreurs

Chaque erreur renvoie une enveloppe JSON cohérente. Les appels échoués ne consomment jamais de crédits.

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

Limites de requêtes

Les limites s'appliquent par clé API, et non par adresse IP, de sorte qu'un bureau partagé ou un agent CI ne sera jamais pénalisé par le trafic de quelqu'un d'autre.

Tarification

Chaque nouveau compte bénéficie de 10 conversions gratuites chaque mois, sans carte bancaire. Vous en avez besoin de plus ? Achetez des images prépayées — n'importe quelle quantité (par lots de 50), avec des réductions sur le volume. Elles n'expirent jamais et se cumulent avec votre quota mensuel gratuit (les conversions gratuites sont consommées en premier).

Crédit automatique : votre solde est mis à jour en quelques secondes après le paiement, via le webhook de paiement. Les remboursements déduisent les crédits achetés, dans la limite du solde actuel. Paiement sécurisé via Lemon Squeezy (TVA gérée automatiquement).

Exemples de code

Copiez-collez et adaptez. L'API utilise du multipart/form-data standard, donc n'importe quel client HTTP fonctionne.

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

Questions fréquemment posées