API documentation

Call vectorizing from your own app. Create a key on the API access page after signing in. Every successful request costs 1 credit.

Authentication

Send Authorization: Bearer <key> on every request. Keys start with pv_live_.

Endpoint

POST https://pixovec.com/api/v1/vectorize

Form fields

file required — the image file (PNG, JPG, WebP, BMP)
preset optional — photo | logo | lineart | poster (default: logo)
mode optional — color | bw, overrides the preset's mode

Response format

Returns JSON by default. Add ?format=svg to get the raw SVG back directly (content-type: image/svg+xml).

JSON request

curl -X POST https://pixovec.com/api/v1/vectorize \
  -H "Authorization: Bearer pv_live_..." \
  -F "file=@logo.png" \
  -F "preset=logo"

JSON response

{
  "svg": "<svg ...>...</svg>",
  "colorCount": 8,
  "width": 512,
  "height": 512,
  "balance": 42
}

Download SVG directly

curl -X POST "https://pixovec.com/api/v1/vectorize?format=svg" \
  -H "Authorization: Bearer pv_live_..." \
  -F "file=@logo.png" \
  -F "preset=logo" \
  -o logo.svg

Error codes

401missing_api_keyNo Authorization header sent.

401invalid_api_keyThe key is invalid or has been revoked.

400missing_fileNo 'file' field in the multipart/form-data body.

400invalid_fileThe file couldn't be read.

422vectorize_failedVectorizing failed (corrupt/unsupported image).

402insufficient_creditsNot enough credits.

500spend_failedSpending the credit failed.

Create an API key