MP4 to SVG API - Convert MP4 to SVG API: Pricing, Documentation

Authentication

Every request is authenticated with your Pixazo API key in the Ocp-Apim-Subscription-Key header — the same key across every Pixazo endpoint.

MP4 frame to SVG (step 2 of 2) generate request

There is no single endpoint that takes an MP4 and returns an SVG, and any documentation claiming otherwise is wrong: image-vectorize is a raster tracer built on potrace, and handing it a video URL simply fails. The supported route is the two-step above — extract a frame, then trace that frame — which is also the more useful shape in practice, because you choose exactly which frame gets vectorized rather than accepting whatever a hidden default picked. Step one returns a PNG still by default and lets you name a position in seconds. Step two thresholds that still to black and white and traces the shapes, so results are strongest on flat, high-contrast frames (logos, lower-thirds, title cards) and weakest on continuous-tone footage. Two calls, two polls, $0.004 in total.

Endpoint: POST https://gateway.pixazo.ai/media-tools/v1/image-vectorize

Request Code

curl -X POST 'https://gateway.pixazo.ai/media-tools/v1/image-vectorize' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"image_url":"https://example.com/frame.png","threshold":50}'

Output

{
  "request_id": "req_9f3c1a7b2e",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/req_9f3c1a7b2e"
}

Webhook (Optional)

Instead of polling, include a webhook_url in the request body and Pixazo will POST the completed job payload to that URL when the conversion finishes. The webhook body is identical to the completed-status response shown under Retrieving Results.

Request Parameters

Example Request

curl -X POST 'https://gateway.pixazo.ai/media-tools/v1/image-vectorize' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"image_url":"https://example.com/frame.png","threshold":50}'

import requests

resp = requests.post(
    "https://gateway.pixazo.ai/media-tools/v1/image-vectorize",
    headers={
        "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
  "image_url": "https://example.com/frame.png",
  "threshold": 50
},
)
print(resp.json())

const res = await fetch("https://gateway.pixazo.ai/media-tools/v1/image-vectorize", {
  method: "POST",
  headers: {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"image_url":"https://example.com/frame.png","threshold":50}),
});
console.log(await res.json());

Response

Every request returns a request_id immediately with a QUEUED status. Use the polling_url (or a webhook) to retrieve the finished file.

{
  "request_id": "req_9f3c1a7b2e",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/req_9f3c1a7b2e"
}

Request Headers

Response Handling

The submit call returns one of the HTTP status codes below. A 202 means the job was accepted — everything else is an error you should handle.

Error Responses

Errors return a JSON body with a machine-readable code and a human-readable message.

{
  "request_id": "req_9f3c1a7b2e",
  "status": "FAILED",
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Your account balance is too low to process this request."
  }
}

Retrieving Results

Poll the status endpoint until the job reaches COMPLETED (or FAILED).

curl 'https://gateway.pixazo.ai/v2/requests/status/req_9f3c1a7b2e' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY'

Response (Completed)

{
  "request_id": "req_9f3c1a7b2e",
  "status": "COMPLETED",
  "model_id": "image-vectorize",
  "output": {
    "media_url": "https://api-assets.pixazo.ai/out/result.svg",
    "media_type": "SVG"
  },
  "error": null,
  "created_at": "2026-01-01T00:00:00Z",
  "completed_at": "2026-01-01T00:00:04Z"
}

Response Fields

Status Values