latestOpenAPI 3.0.02026-08-108356.0 KB

fa6d2efc9689

Editing Endpoints

Increase Resolution - up to 8K

Try out this capability in Bria's sandbox

Description Initiates an asynchronous resolution upscaling job for a video.

Upscales up to 8K output!

Response behavior:

  • Returns HTTP 202 with request_id and status_url

  • Check job status by polling status_url or by calling the Status Service with the request_id until a terminal status is returned

Supported input containers:

  • .mp4, .mov, .webm, .avi, .gif

Supported input codecs:

  • H.264, H.265 (HEVC), VP9, AV1, PhotoJPEG

Input attributes preserved in output:

  • Aspect Ratio

  • Frame Rate

  • Color Bit Depth

  • Audio if present

  • Transparency if present and supported by the selected output preset

Limits:

  • Max input duration: 60 seconds

  • Max output resolution: 7680x4320 (8K). If the selected desired_increase would exceed this limit the server returns 422 Unprocessable Entity.

Encoding:

  • Bitrate is adjusted automatically to match the target resolution to preserve quality.
post/increase_resolution

Headers

api_tokenstring required

Request body

videostring required

Publicly accessible URL of the input video

desired_increase2 | 4

Integer scale factor for upscaling

output_container_and_codec'mp4_h264' | 'mp4_h265' | 'webm_vp9' | 'mov_h265' | 'mov_proresks' | 'mkv_h264' | 'mkv_h265' | 'mkv_vp9' | 'gif'

Output container and codec preset

preserve_audioboolean
webhook_urlstring uri

Optional URL for receiving the result via webhook when the async job completes. See Webhooks.

Response

Accepted

request_idstring required
status_urlstring required