SVG to JPG API: Render SVG Vectors into Compressed JPG Images

Authentication

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

SVG to JPG generate request

SVG describes shapes with math, which is ideal for scaling but useless to the many platforms and CDNs that expect a lightweight photographic-style raster. Rendering to JPG yields a compact, broadly compatible bitmap that is easy to serve at scale, at the cost of the alpha channel: because JPG has no transparency, any transparent SVG regions are flattened onto a solid background during rasterization. Pixazo's /media-tools/v1/svg-rasterize endpoint renders the vector and encodes it as JPG, a good fit when file size and compatibility matter more than a see-through background. This capability is currently offered in preview.

Endpoint: POST https://gateway.pixazo.ai/media-tools/v1/svg-rasterize

Request Code

curl -X POST 'https://gateway.pixazo.ai/media-tools/v1/svg-rasterize' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"svg_url":"https://example.com/input.svg","to_format":"jpg","width":1024}'

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/svg-rasterize' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"svg_url":"https://example.com/input.svg","to_format":"jpg","width":1024}'

import requests

resp = requests.post(
    "https://gateway.pixazo.ai/media-tools/v1/svg-rasterize",
    headers={
        "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
  "svg_url": "https://example.com/input.svg",
  "to_format": "jpg",
  "width": 1024
},
)
print(resp.json())

const res = await fetch("https://gateway.pixazo.ai/media-tools/v1/svg-rasterize", {
  method: "POST",
  headers: {
    "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"svg_url":"https://example.com/input.svg","to_format":"jpg","width":1024}),
});
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": "svg-rasterize",
  "output": {
    "media_url": "https://api-assets.pixazo.ai/out/result.jpg",
    "media_type": "JPG"
  },
  "error": null,
  "created_at": "2026-01-01T00:00:00Z",
  "completed_at": "2026-01-01T00:00:04Z"
}

Response Fields

Status Values