MP4 to HEIC API - Convert MP4 to HEIC 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 HEIC generate request

Grabbing a thumbnail or poster frame from a video usually means a desktop editor. The MP4 to HEIC API does it with one call: give it a video URL and a timestamp, and it decodes that frame and encodes it as HEIC. Ideal for thumbnails, posters, previews and contact sheets.

Endpoint: POST https://gateway.pixazo.ai/media-tools/v1/video-extract-frame

Request Code

curl -X POST 'https://gateway.pixazo.ai/media-tools/v1/video-extract-frame' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"video_url":"https://example.com/input.mp4","position":5,"to_format":"heic"}'

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/video-extract-frame' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"video_url":"https://example.com/input.mp4","position":5,"to_format":"heic"}'

import requests

resp = requests.post(
    "https://gateway.pixazo.ai/media-tools/v1/video-extract-frame",
    headers={
        "Ocp-Apim-Subscription-Key": "YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
  "video_url": "https://example.com/input.mp4",
  "position": 5,
  "to_format": "heic"
},
)
print(resp.json())

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

Response Fields

Status Values