API PixelToPath

Início Rápido

Três passos e você estará convertendo imagens para SVG direto do seu terminal, de seus scripts ou do seu aplicativo.

Sua primeira conversão

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

Referência interativa: pixel-to-path.com/v1/docs (OpenAPI/Swagger).

Autenticação

Toda solicitação é autenticada com um token Bearer no cabeçalho Authorization:

Authorization: Bearer ptp_live_0123abc…

• Chaves são segredos: elas são armazenadas com hash no servidor e exibidas apenas uma vez na criação. Perdeu a chave? Revogue-a e crie uma nova.
• Uma conta, várias chaves: crie até 5 chaves ativas para separar seus projetos. Sua cota mensal gratuita é contabilizada por conta, não por chave.
• Revogação instantânea: uma chave revogada para de funcionar imediatamente, seja pelo portal ou pela resposta da API de uma conta banida.

POST /v1/convert

Upload + conversão em uma única chamada sem estado. Uma chamada bem-sucedida custa no máximo 1 crédito — chamadas com falha, inválidas ou limitadas não custam nada.

Requisição (multipart/form-data)

Dois motores, escolhidos por "colormode"

A API executa exatamente os mesmos motores que o conversor online gratuito e o aplicativo de desktop:

As imagens são pré-processadas exatamente como no site: o lado mais longo é redimensionado para 1500 px antes da conversão, e a API retorna o tipo de imagem detectado (line_art, logo, photo ou illustration) no cabeçalho X-Detected-Type.

Resposta

Em caso de sucesso: 200 OK com image/svg+xml — o corpo da resposta é o próprio arquivo SVG. Cabeçalhos informativos:

GET /v1/me

Status da conta para a chave usada na chamada. Gratuito — nunca é descontado da sua cota, nunca é cobrado.

Exemplo de resposta

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

Erros

Todo erro retorna um envelope JSON consistente. Chamadas que falham nunca consomem 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 }
  }
}

Limites de taxa

Os limites se aplicam por chave de API, não por IP, para que um escritório compartilhado ou um runner de CI nunca seja penalizado pelo tráfego de outra pessoa.

Preços

Toda nova conta ganha 10 conversões grátis todo mês, sem a necessidade de um cartão de crédito. Precisa de mais? Compre imagens pré-pagas — qualquer quantidade (em lotes de 50), com descontos por volume. Elas nunca expiram e acumulam com sua cota mensal gratuita (as conversões gratuitas são consumidas primeiro).

Crédito automático: seu saldo é atualizado em segundos após o pagamento, via webhook de pagamento. Os reembolsos deduzem os créditos comprados, limitados ao saldo atual. Checkout seguro pela Lemon Squeezy (IVA processado automaticamente).

Exemplos de código

Copie, cole e adapte. A API usa o multipart/form-data padrão, portanto, qualquer cliente HTTP funciona.

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

Perguntas frequentes