--- type: AI Model id: image-vectorize-api title: Image Vectorizer API provider: Pixazo description: "Trace a raster image into a true vector SVG with potrace — real editable paths, not a bitmap wrapped in an SVG tag. The source is flattened onto white and thresholded to black-and-white first, so this is built for logos, line art and silhouettes rather than photographs." resource: https://www.pixazo.ai/models/image-vectorize-api docs_url: https://www.pixazo.ai/models/image-vectorize-api latest_version: v1 tags: - image-vectorizer - pixazo variants: - id: media-vectorize-v1 name: Image Vectorizer 1.0 version: 1.0 capabilities: - Vectorize timestamp: 2026-08-16T15:44:59.489Z --- # Image Vectorizer API > Provider: **Pixazo** > Source: https://www.pixazo.ai/models/image-vectorize-api Trace a raster image into a true vector SVG with potrace — real editable paths, not a bitmap wrapped in an SVG tag. The source is flattened onto white and thresholded to black-and-white first, so this is built for logos, line art and silhouettes rather than photographs. ## Image Vectorizer 1.0 ### Vectorize ## Base URL ``` https://gateway.pixazo.ai/media-tools/v1/image-vectorize ``` ## Authentication All requests require an API key passed via header. **Pricing:** Billed at **$0.002 per image** — a flat rate per call, whatever the resolution of the source. **Retries:** this is an asynchronous job on shared encoding capacity, so a request can occasionally come back `processing_failed` or take much longer than usual. These are transient and succeed on a retry, and a failed job is **never charged** — the wallet hold is released. If you chain these tools, retry a failed step rather than failing the whole pipeline. Header Type Required Description Ocp-Apim-Subscription-Key string Yes Your API subscription key ## Image Vectorizer generate request ## Request Code HTTP Python JavaScript cURL ``` POST https://gateway.pixazo.ai/media-tools/v1/image-vectorize Content-Type: application/json Cache-Control: no-cache Ocp-Apim-Subscription-Key: YOUR_API_KEY { "image_url": "https://api-assets.pixazo.ai/media-api-test/t.png", "threshold": 50 } ``` ``` import requests url = "https://gateway.pixazo.ai/media-tools/v1/image-vectorize" headers = { "Content-Type": "application/json", "Cache-Control": "no-cache", "Ocp-Apim-Subscription-Key": "YOUR_API_KEY" } data = { "image_url": "https://api-assets.pixazo.ai/media-api-test/t.png", "threshold": 50 } response = requests.post(url, json=data, headers=headers) print(response.json()) ``` ``` const url = "https://gateway.pixazo.ai/media-tools/v1/image-vectorize"; const headers = { "Content-Type": "application/json", "Cache-Control": "no-cache", "Ocp-Apim-Subscription-Key": "YOUR_API_KEY" }; const data = { "image_url": "https://api-assets.pixazo.ai/media-api-test/t.png", "threshold": 50 }; fetch(url, { method: "POST", headers: headers, body: JSON.stringify(data) }) .then(response => response.json()) .then(data => console.log(data)); ``` ``` curl -X POST "https://gateway.pixazo.ai/media-tools/v1/image-vectorize" \ -H "Content-Type: application/json" \ -H "Cache-Control: no-cache" \ -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ --data-raw '{ "image_url": "https://api-assets.pixazo.ai/media-api-test/t.png", "threshold": 50 }' ``` ## Output ``` { "request_id": "media-vectorize_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "QUEUED", "polling_url": "https://gateway.pixazo.ai/v2/requests/status/media-vectorize_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } ``` [Try Now](https://api.pixazo.ai/api-details#api=media-tools&operation=image-vectorize) ## Webhook (Optional) Add the `X-Webhook-URL` header to your generate request to receive a POST callback instead of polling. ``` X-Webhook-URL: https://your-server.com/webhook/callback ``` ## Request Parameters - Image Vectorizer generate request Parameter Required Type Default Allowed values / range Description image\_url Yes string — HTTP(S) URL to an image The image to trace. Works on any raster format the converter accepts. threshold No number `50` 0 – 100 Where the black/white cut falls, as a percentage. Lower keeps only the darkest pixels; higher pulls more of the midtones into the traced shape. The output is an **SVG** of real vector paths — editable in Illustrator, Figma or Inkscape — not a bitmap wrapped in an `` tag. The source is flattened onto white and reduced to black and white before tracing, so this is built for **logos, line art, icons and silhouettes**. A photograph traces to a large, noisy path set rather than something useful. Transparent PNGs are flattened first on purpose: without it the whole image thresholds to black and traces as one giant rectangle. EXIF rotation is applied before tracing, since an SVG carries no orientation tag to correct it later. ## Example Request ``` { "image_url": "https://api-assets.pixazo.ai/media-api-test/t.png", "threshold": 50 } ``` ## Response ``` { "request_id": "media-vectorize_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "QUEUED", "polling_url": "https://gateway.pixazo.ai/v2/requests/status/media-vectorize_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" } ``` ## Request Headers Header Value Content-Type application/json Cache-Control no-cache Ocp-Apim-Subscription-Key YOUR\_API\_KEY ## Response Handling Common status codes. Code Meaning 202 Accepted — Request queued 400 Bad Request 401 Unauthorized 402 Insufficient Balance 403 Forbidden 429 Too Many Requests 500 Internal Server Error ## Error Responses Queue system errors and model validation errors. ### Queue System Errors ``` // 402 — Insufficient balance { "error": "Insufficient Balance", "message": "Your wallet does not have enough balance." } ``` ``` // 400 — Model not found { "error": "Model not found", "message": "Model 'media-vectorize' not found or is disabled" } ``` ### Error via Status/Webhook ``` { "request_id": "media-vectorize_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "ERROR", "model_id": "media-vectorize", "error": "Description of the error", "output": null } ``` ## Retrieving Results Poll the universal status endpoint to check progress and retrieve results. ### Endpoint ``` GET https://gateway.pixazo.ai/v2/requests/status/{request_id} Ocp-Apim-Subscription-Key: YOUR_API_KEY ``` ## cURL Example ``` curl -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \ "https://gateway.pixazo.ai/v2/requests/status/media-vectorize_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" ``` ## Response (Completed) ``` { "request_id": "media-vectorize_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "status": "COMPLETED", "model_id": "media-vectorize", "error": null, "output": { "media_url": [ "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/media-vectorize_019dxxxx/output.svg" ], "media_type": "image/svg+xml" }, "created_at": "2026-03-31T10:00:00.000Z", "updated_at": "2026-03-31T10:00:15.000Z", "completed_at": "2026-03-31T10:00:15.000Z" } ``` ## Response Fields Field Type Description request\_id string Unique request identifier status string QUEUED, PROCESSING, COMPLETED, FAILED, or ERROR model\_id string Model that processed the request error string|null Error message if failed output.media\_url array URLs to generated media (R2 CDN) output.media\_type string MIME type of the output created\_at string When request was created completed\_at string When request completed polling\_url string Status URL (initial response only) ## Status Values Status Description QUEUED Request accepted, waiting to be processed PROCESSING Being processed by the model COMPLETED Done — output contains the result FAILED Failed — check error field ERROR System error — not charged ## Status Flow ``` QUEUED → PROCESSING → COMPLETED → FAILED → ERROR ``` ## Typical Workflow 1. **Send a generate request** to the API endpoint 2. **Save the `request_id`** from the response 3. **Poll** every 5-10 seconds: `GET /v2/requests/status/{request_id}` 4. **When `status` is `"COMPLETED"`**, download from `output.media_url` **Tip:** Use `X-Webhook-URL` header to get a callback instead of polling.