API de PixelToPath

Inicio rápido

Tres pasos y estarás convirtiendo imágenes a SVG desde tu terminal, tus scripts o tu aplicación.

Tu primera conversió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

Referencia interactiva: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Autenticación

Cada solicitud se autentica con un token Bearer en el encabezado Authorization:

Authorization: Bearer ptp_live_0123abc…

• Las claves son secretas: se almacenan con hash en el servidor y se muestran solo una vez al crearlas. ¿Perdiste tu clave? Revócala y crea una nueva.
• Una cuenta, varias claves: crea hasta 5 claves activas para separar tus proyectos. Tu cuota gratuita mensual se cuenta por cuenta, no por clave.
• Revocación instantánea: una clave revocada deja de funcionar inmediatamente, desde el portal o en la respuesta de la API de una cuenta baneada.

POST /v1/convert

Subida + conversión en una única llamada stateless. Una llamada exitosa cuesta como máximo 1 crédito; las llamadas fallidas, no válidas o con rate-limit no cuestan nada.

Solicitud (multipart/form-data)

Dos motores, elegidos por "colormode"

La API ejecuta exactamente los mismos motores que el conversor en línea gratuito y la aplicación de escritorio:

Las imágenes se preprocesan exactamente igual que en el sitio web: el lado más largo se redimensiona a 1500 px antes de la conversión, y la API devuelve el tipo de imagen detectado (line_art, logo, photo o illustration) en el encabezado X-Detected-Type.

Respuesta

En caso de éxito: 200 OK con image/svg+xml — el cuerpo es el archivo SVG en sí. Encabezados informativos:

GET /v1/me

Estado de la cuenta para la clave utilizada. Gratis — nunca se descuenta de tu cuota, nunca se cobra.

Ejemplo de respuesta

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

Errores

Cada error devuelve un JSON consistente. Las llamadas fallidas nunca consumen créditos.

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

Límites de tasa

Los límites se aplican por clave de API, no por IP, por lo que una oficina compartida o un runner de CI nunca es penalizado por el tráfico de otra persona.

Precios

Cada cuenta nueva obtiene 10 conversiones gratuitas cada mes, sin necesidad de tarjeta de crédito. ¿Necesitas más? Compra imágenes prepago: cualquier cantidad (en lotes de 50), con descuentos por volumen. Nunca caducan y se acumulan con tu cuota gratuita mensual (las conversiones gratuitas se consumen primero).

Crédito automático: tu saldo se actualiza a los pocos segundos del pago, a través del webhook de pago. Los reembolsos deducen los créditos comprados, limitados al saldo actual. Pago seguro a través de Lemon Squeezy (el IVA se maneja automáticamente).

Ejemplos de código

Copia, pega y adapta. La API habla multipart/form-data puro, por lo que cualquier cliente HTTP funcionará.

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

Preguntas frecuentes