Image to 300 DPI API - Convert Image to 300 DPI 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.

Set 300 DPI generate request

Screen images ship at 72 DPI, but commercial and offset printing expects 300 DPI so text and detail stay crisp at physical size. This endpoint works in two modes. In NATIVE mode — image_url plus dpi, nothing else — it rewrites the density tag at the image's own pixel dimensions and preserves the source format through a metadata-only chunk copy, so no re-encode and no generation loss. Pass format to convert as well (tiff, tif, png, jpg, jpeg). In RESAMPLE mode you give a named size such as 8x10 or a4, or explicit width_in and height_in, and the image is resized to that physical size at the requested DPI, cover-cropped to fit, with alpha flattened onto white and EXIF/GPS stripped; TIFF output keeps its ICC profile, PNG does not. The important behaviour to design around is the refusal: if your source has too few pixels for the requested print, the API answers 422 with the numbers — the pixels you have against the pixels the print needs — instead of upscaling behind your back. Pass allow_upsample: true when you would rather have the upscale than the error. Output area is capped at 24 MP, roughly 12x18 inches at 300 DPI, and anything larger is rejected as a free 400 before a hold is placed. Flat $0.002 per image.

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

Request Code

curl -X POST 'https://gateway.pixazo.ai/media-tools/v1/image-dpi' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"image_url":"https://example.com/input.jpg","dpi":300}'

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-dpi' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"image_url":"https://example.com/input.jpg","dpi":300}'

import requests

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

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

Response Fields

Status Values