Skip to content
HALOWERK

Tonwerk

video quality compare

Both videos are decoded from start_s for duration_s (at most 60 s), converted to 8-bit YUV 4:2:0 and aligned frame by frame at the frame rate of the reference; the distorted video is scaled to the reference size with a bicubic filter when the sizes differ (the display aspect ratios must agree within 2 %). ffmpeg 6.1 psnr and ssim filters write per-frame statistics; overall PSNR is computed from the mean squared error over all frames (as ffmpeg does), SSIM is the mean of the per-frame values.

POST https://ton.halowerk.com/v1/video-quality-compare

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
reference_base64stringNoThe original (reference) video as base64 (MP4/MOV, WebM/MKV, AVI, MPEG-TS, MPEG-PS, FLV, Ogg or animated GIF; at most 10 MiB decoded; a data: URL prefix is accepted).
reference_urlstringNoPublic http(s) URL of the the original (reference) video (at most 10 MiB; private, local and reserved addresses are refused).
distorted_base64stringNoThe encoded (distorted) video as base64 (MP4/MOV, WebM/MKV, AVI, MPEG-TS, MPEG-PS, FLV, Ogg or animated GIF; at most 10 MiB decoded; a data: URL prefix is accepted).
distorted_urlstringNoPublic http(s) URL of the the encoded (distorted) video (at most 10 MiB; private, local and reserved addresses are refused).
start_snumberNoStart of the analysed range in seconds.
duration_snumberNoLength of the analysed range in seconds (at most 60; default: to the end of the video).
worst_framesintegerNoNumber of lowest-SSIM frames listed.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "reference_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The original (reference) video as base64 (MP4/MOV, WebM/MKV, AVI, MPEG-TS, MPEG-PS, FLV, Ogg or animated GIF; at most 10 MiB decoded; a data: URL prefix is accepted)."
    },
    "reference_url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https?://",
      "maxLength": 2048,
      "description": "Public http(s) URL of the the original (reference) video (at most 10 MiB; private, local and reserved addresses are refused)."
    },
    "distorted_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The encoded (distorted) video as base64 (MP4/MOV, WebM/MKV, AVI, MPEG-TS, MPEG-PS, FLV, Ogg or animated GIF; at most 10 MiB decoded; a data: URL prefix is accepted)."
    },
    "distorted_url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https?://",
      "maxLength": 2048,
      "description": "Public http(s) URL of the the encoded (distorted) video (at most 10 MiB; private, local and reserved addresses are refused)."
    },
    "start_s": {
      "type": "number",
      "minimum": 0,
      "maximum": 36000,
      "default": 0,
      "description": "Start of the analysed range in seconds."
    },
    "duration_s": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 60,
      "description": "Length of the analysed range in seconds (at most 60; default: to the end of the video)."
    },
    "worst_frames": {
      "type": "integer",
      "minimum": 0,
      "maximum": 20,
      "default": 5,
      "description": "Number of lowest-SSIM frames listed."
    }
  }
}

Open original schema

Published input example

{
  "reference_url": "https://upload.wikimedia.org/wikipedia/commons/2/2c/Rotating_earth_%28large%29.gif",
  "distorted_url": "https://upload.wikimedia.org/wikipedia/commons/2/2c/Rotating_earth_%28large%29.gif",
  "worst_frames": 3
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’