Image to Video 1 API: Pricing, Documentation

Authentication

All requests require an API key passed via header.

Pricing: Billed at $0.002 per clip — a flat rate per call. Duration does not change the price: a 1-second clip and a 60-second clip both cost $0.002.

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.

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 to Video generate request

What this endpoint actually does: it holds your image on screen, unchanged, for duration_seconds and encodes that as a silent H.264 MP4. It is a deterministic re-wrap, not a generative model — nothing moves, nothing is invented, there is no pan, zoom, parallax or AI-generated motion of any kind. The same input always produces the same output. If you want real motion, use one of the image-to-video generation models in the catalog instead; they are priced per second and cost far more than this.

Those two parameters are the whole API. There is no prompt, no fps, no width/height, and no motion, zoom or effect setting. Anything else you send is not honoured.

Output: H.264 video in yuv420p, no audio track, running exactly duration_seconds long. The frame is downscaled to fit inside a 1920×1920 box, preserving aspect ratio, and is never upscaled — a 400×300 raster source gives you a 400×300 video. Dimensions are nudged to even numbers, which yuv420p requires. Transparency (PNG, WebP, SVG) is flattened, because MP4 has no alpha channel.

SVG is the exception to “never upscaled”. A vector file has no native pixel size, so there is nothing to upscale from: an SVG is rasterised by librsvg to the 1920×1920 box, aspect ratio preserved, whatever the width/height or viewBox in the file says. A 400×300 SVG therefore comes back as a 1920×1440 video, not a 400×300 one. The 50 megapixel source limit does not apply to SVG either — there are no source pixels to count.

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

Error via Status/Webhook

{
  "request_id": "media-image-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "ERROR",
  "model_id": "media-image-to-video",
  "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 -H "Ocp-Apim-Subscription-Key: YOUR_API_KEY" \
  "https://gateway.pixazo.ai/v2/requests/status/media-image-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

{
  "request_id": "media-image-to-video_019dxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "COMPLETED",
  "model_id": "media-image-to-video",
  "error": null,
  "output": {
    "media_url": [
      "https://pub-582b7213209642b9b995c96c95a30381.r2.dev/v1/media-image-to-video_019dxxxx/output.mp4"
    ],
    "media_type": "video/mp4"
  },
  "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 X-Webhook-URL header to get a callback instead of polling.