Vectorizza
Language
Sign in

API documentation

Generated from the published OpenAPI. Authenticate with your dashboard key in the Authorization: Bearer header.

Vectorizza API v1.0.0

Raster to vector. Credits: test 0, preview 0.2, production 1.0, download of an unpaid preview 0.8, download of a paid token 0.

Server: https://api.vectorizza.com

POST/v1/vectorize

Vectorize an image.

API key

Body multipart/form-data

FieldTypeDescription
imagerequiredfilePNG, JPEG or WebP image.
modeproduction | preview | testproduction charges 1.0; preview charges 0.2 and watermarks; test is free and watermarks.default: production
formatsvg | pdf | eps | dxf | pngOutput format. preview and test only accept svg.default: svg
optionsstringJSON object with engine options.

Responses

  • 200 The vector file.

    image/svg+xml, application/pdf, application/postscript, application/dxf, image/png

    X-Credits-Charged
    Credits charged by this call.
    X-Credits-Remaining
    Credits available after this call.
    X-Download-Token
    Download token, valid for 24 hours (preview and production).

Errors

  • 400invalid_requestinvalid_options
  • 401unauthorized
  • 402insufficient_credits
  • 413image_too_large
  • 415unsupported_image
  • 422invalid_image
  • 503engine_unavailable

Example

curl -X POST "https://api.vectorizza.com/v1/vectorize" \
  -H "Authorization: Bearer $VECTORIZZA_API_KEY" \
  -F "image=@image.png" \
  -F "mode=production" \
  -F "format=svg" \
  -o "result.svg"

POST/v1/download

Exchange a download token for a clean file.

API key

Body application/json

FieldTypeDescription
tokenrequiredstring
formatsvg | pdf | eps | dxf | pngdefault: svg

Responses

  • 200 The clean vector file.

    image/svg+xml, application/pdf, application/postscript, application/dxf, image/png

    X-Credits-Charged
    Credits charged by this call.
    X-Credits-Remaining
    Credits available after this call.

Errors

  • 400invalid_request
  • 401unauthorized
  • 402insufficient_credits
  • 404token_not_found
  • 503engine_unavailable

Example

curl -X POST "https://api.vectorizza.com/v1/download" \
  -H "Authorization: Bearer $VECTORIZZA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token":"<token>","format":"svg"}' \
  -o "result.svg"

GET/v1/account

Account balance.

API key

Responses

  • 200 The account.

    application/json

Errors

  • 401unauthorized

Example

curl "https://api.vectorizza.com/v1/account" \
  -H "Authorization: Bearer $VECTORIZZA_API_KEY" \
  -o "result.json"

GET/v1/openapi.json

This document.

No authentication

Responses

  • 200 OpenAPI 3.1 document.

Example

curl "https://api.vectorizza.com/v1/openapi.json"