MediaRuntime product

Image Processing

Convert JPG, PNG, WebP, and AVIF; generate responsive derivatives; control fit and crop behavior; remove backgrounds; and apply account watermarks asynchronously.

Read the API documentation Try the Sandbox

Multi-format, multi-size derivatives

Fit, cover, contain and fill modes

Smart crop, background removal and watermarking

POST https://mediaruntime.com/v1/transcode

From source to delivered artifacts

Provide one image

Use a fetchable HTTPS URL for a supported source image, or use the optional upload flow when the source exists only as local bytes.

Describe every derivative

Set the target width, height, mode, format and quality for each image required by your product.

Consume the manifest

Read the completed job’s output manifest or bundle; generated files have source metadata removed for privacy.

What you can build

Format conversion

Convert supported sources to JPG, PNG, WebP, or AVIF. Use the source dimensions when only the encoding should change.

Responsive derivatives

Create several widths, aspect ratios and formats in one job for web, mobile, social cards, thumbnails, or product catalogs.

Precise geometry

Use fit to stay inside a box, cover to crop and fill it, contain to pad it, or fill to force exact dimensions.

Premium visual processing

Request WebP/AVIF, larger derivative sets, wider outputs, smart crop, background removal, moderation, or an account watermark.

Relevant presets

image_multi_v1Formats: jpg · png · webp · avifModes: fit · cover · contain · fillOptional: smart crop · background removal · moderation · watermark

Example job request

Submit from a trusted server with your MediaRuntime API key. The source can be any fetchable HTTPS URL; uploading through MediaRuntime is optional.

{
  "file_url": "https://cdn.example.com/media/product-photo.png",
  "metadata": {
    "media_type": "image",
    "asset_id": "product-photo-0426"
  },
  "outputs": [
    {
      "type": "image",
      "preset": "image_multi_v1",
      "path_suffix": "responsive",
      "images": [
        {
          "width": 1600,
          "height": 1200,
          "mode": "fit",
          "format": "webp",
          "quality": 84
        },
        {
          "width": 600,
          "height": 600,
          "mode": "cover",
          "format": "jpg",
          "quality": 88
        }
      ]
    }
  ]
}