PNG to WebP API - Convert PNG to WebP API: Pricing, Documentation

Authentication

All requests require an API key passed via header.

Pricing: Billed at $0.002 per image — a flat rate per call. A 12-megapixel photo and a 200-pixel thumbnail cost exactly the same.

Retries: this is an asynchronous job on shared encoding capacity, so a request can occasionally come back processing_failed or take longer than usual. These are transient and succeed on a retry, and a failed job is never charged — the wallet hold is released.

PNG to WebP generate request

Request Code

POST https://gateway.pixazo.ai/media-tools/v1/image-convert
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",
  "to_format": "webp",
  "quality": 90
}

import requests
url = "https://gateway.pixazo.ai/media-tools/v1/image-convert"
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",
    "to_format": "webp",
    "quality": 90
}
response = requests.post(url, json=data, headers=headers)
print(response.json())

const url = "https://gateway.pixazo.ai/media-tools/v1/image-convert";
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", "to_format": "webp", "quality": 90 };
fetch(url, { method: "POST", headers, body: JSON.stringify(data) })
  .then(r => r.json())
  .then(console.log);

curl -X POST "https://gateway.pixazo.ai/media-tools/v1/image-convert" \
  -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", "to_format": "webp", "quality": 90 }'

Output

{
  "request_id": "media-convert-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/media-convert-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

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 - PNG to WebP generate request

EXIF orientation: the Orientation tag is applied before metadata is stripped — the reverse order deletes the rotation instead of applying it, which is why a portrait phone shot so often arrives sideways elsewhere.

Transparency is flattened onto white when the target format has no alpha channel (JPG, BMP). A black flatten is what turns a transparent logo into a dark rectangle. If the source holds several frames and the target holds one, you get frame 0.

Example Request

{
  "image_url": "https://api-assets.pixazo.ai/media-api-test/t.png",
  "to_format": "webp",
  "quality": 90
}

Response

{
  "request_id": "media-convert-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "QUEUED",
  "polling_url": "https://gateway.pixazo.ai/v2/requests/status/media-convert-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Request Headers

Response Handling

Common status codes.

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-convert-image' not found or is disabled"
}

Error via Status/Webhook

{
  "request_id": "media-convert-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "media-convert-image",
  "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-convert-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Response (Completed)

{
  "request_id": "media-convert-image_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "media-convert-image",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/media-convert-image_019dxxxx/output.webp"
    ],
    "media_type": "image/webp"
  },
  "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

Status Values

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 the X-Webhook-URL header to get a callback instead of polling.