VideoUpscaling

4x Video Upscaler

Upload a video and download it four times larger.

ESRGAN 4x Video Upscale

Real-ESRGAN by Xintao Wang

4x-UltraSharp by Kim2091, CC BY-NC-SA 4.0; converted to ONNX by Mesh, unchanged learned tensors.

Model licenses

Real-ESRGAN x4plus original release ONNX derivative · BSD-3-Clause

Retain the original copyright notice, all three BSD conditions and warranty disclaimer with distributed copies. No endorsement using author/contributor names without permission.

Distributed license

Notice

Original 4x-UltraSharp ONNX conversion by Mesh · CC-BY-NC-SA-4.0

NonCommercial only. Preserve attribution, full license and modification notice. ShareAlike applies to adapted licensed material. Private compute only, unmetered, requester and operator acceptance required; no global-network execution. Acceptance does not grant commercial permission.

Distributed license

Notice

FreeOnlineUnlimitedUltraSharp API access

API reference

Submit via REST

Use your personal API key (msk_…) to create jobs for this workload from your own tools. Jobs started this way run on the same devices you connected on Your Devices — at least one has to be online.

Hide API details
POSThttps://cp.meshlabs.cloud/v1/organizations/jobs

Authenticate with X-Organization-Api-Key: msk_your_personal_api_key. The header name matches org keys; personal keys use the same endpoint.

Input files:Call POST https://cp.meshlabs.cloud/v1/organizations/job-inputs/presign with the same API key, upload your file to the returned upload_url, then pass download_url in job_spec (for example as input_image_url).

Request body

{
  "workload_type": "esrgan-video-upscale",
  "job_spec": {
    "max_height": 480,
    "halo": 64,
    "overlap_frames": 0,
    "temporal_overlap": false,
    "crf": 18,
    "frames_per_unit": 3,
    "fps": 24,
    "input_video_url": "https://…/your-input.png",
    "scale_factor": 4,
    "variant": "ultrasharp"
  }
}

job_spec fields

FieldRequiredDefaultDescription
max_heightNo480Cap on the decoded (input) frame height; larger sources are downscaled before upscaling. 480 -> up to 1920px output height.
haloNo64Tile overlap (blend zone) in LR pixels on each edge.
overlap_framesNo0Adjacent chunks share this many frames; assemble cosine-blends the copies so chunk boundaries do not flicker. 0 = off. Each unit still processes frames_per_unit frames (the 3-frame / 2-minute lease lesson). Tile size stays job-spec, never deviceCaps.
temporal_overlapNofalseWhen true and overlap_frames is 0, enable a 1-frame overlap blend. Default false — opt in; not turned on silently.
crfNo18H.264 CRF for the assembled MP4 (lower = higher quality).
frames_per_unitNo3Frames processed per work unit (chunk granularity).
frame_countNo—Total frames to process at `fps` (= ceil(duration * fps), capped). Clients that decoded the video metadata should supply this — it lets the server fan the job out across nodes. Falls back to duration_seconds, else a single work unit processes the whole video.
duration_secondsNo—Source video duration in seconds. Auto-filled by the Solutions Hub when a video file is selected; used to derive frame_count.
fpsNo24Frame sampling rate. Output plays back at the same fps.
input_video_urlYes—Presigned URL of the source (low-resolution) video to upscale.
scale_factorNo4Spatial upscale factor (fixed 4x for Real-ESRGAN RRDBNet).
variantNoultrasharpUltraSharp: preferred detail, private NonCommercial use with terms acceptance. x4plus: BSD-3-Clause alternative.

cURL

curl -X POST https://cp.meshlabs.cloud/v1/organizations/jobs \
  -H "X-Organization-Api-Key: msk_your_personal_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "workload_type": "esrgan-video-upscale",
  "job_spec": {
    "max_height": 480,
    "halo": 64,
    "overlap_frames": 0,
    "temporal_overlap": false,
    "crf": 18,
    "frames_per_unit": 3,
    "fps": 24,
    "input_video_url": "https://…/your-input.png",
    "scale_factor": 4,
    "variant": "ultrasharp"
  }
}'
GEThttps://cp.meshlabs.cloud/v1/organizations/jobs/{job_id}

Poll with the same API key until status is terminal (COMPLETED, FAILED, CANCELED, or MODERATION_BLOCKED). When content moderation is enabled, jobs may start in MODERATION_PENDING before entering the compute queue. Completed jobs include presigned download_url values on each output.

Create response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "workload_type": "esrgan-video-upscale",
  "status": "PENDING",
  "job_spec_json": {
    "max_height": 480,
    "halo": 64,
    "overlap_frames": 0,
    "temporal_overlap": false,
    "crf": 18,
    "frames_per_unit": 3,
    "fps": 24,
    "input_video_url": "https://…/your-input.png",
    "scale_factor": 4,
    "variant": "ultrasharp"
  },
  "work_units": [],
  "outputs": [],
  "created_at": "2026-06-08T12:00:00Z",
  "updated_at": "2026-06-08T12:00:00Z"
}

Completed response

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "workload_type": "esrgan-video-upscale",
  "status": "COMPLETED",
  "job_spec_json": {
    "max_height": 480,
    "halo": 64,
    "overlap_frames": 0,
    "temporal_overlap": false,
    "crf": 18,
    "frames_per_unit": 3,
    "fps": 24,
    "input_video_url": "https://…/your-input.png",
    "scale_factor": 4,
    "variant": "ultrasharp"
  },
  "work_units": [
    {
      "id": "…",
      "index": 0,
      "status": "COMPLETED"
    }
  ],
  "outputs": [
    {
      "id": "…",
      "output_type": "<output type>",
      "filename": "<output filename>",
      "size_bytes": 524288,
      "download_url": "<presigned output download URL>"
    }
  ],
  "created_at": "2026-06-08T12:00:00Z",
  "updated_at": "<completion timestamp>"
}

Upload a video and download a version about four times larger. Free video upscaler on devices you connect. The first run downloads the model; later clips start faster.