Skip to navigation

Upscale a video

Upscale a video to 1080p, 4K or 8K. On completion, the result contains video_url, an H.264 MP4.

The output keeps the input’s aspect ratio and is as large as fits 1920×1080 (1080p), 3840×2160 (4k) or 7680×4320 (8k). For a portrait input the box is turned to portrait (1080×1920, 2160×3840 or 4320×7680). Width and height are rounded to even numbers. For example, at 1080p a 1280×720 input becomes 1920×1080; at 4k a 1920×1080 input becomes 3840×2160 and a 1440×1080 input becomes 2880×2160; at 8k a 1080×1920 input becomes 4320×7680. The output keeps the input’s audio (as stereo) and uses the input’s frame rate, rounded to a whole number.

Responds immediately with the job id and created_at timestamp. Poll GET /v2/video-upscale/{id} until the status is completed.

Requests that violate the content policy fail the job with content_filtered_error. An account without enough credit fails the same way, with insufficient_funds_error.

Billed per second of input video. See Pricing.

Authentication

AuthorizationBearer
API key authentication

Request

This endpoint expects an object.
video_uristringRequired

Input video in HTTPS URL or base64 data URI format. See Input Formats for supported formats. The video must be H.264 or HEVC (H.265).

Max 200 MB (data URIs have a lower limit). The short side must be at least 480 pixels. The long side can be up to 7680 pixels and the short side up to 4320 pixels, so 8K video is accepted in landscape (7680×4320) or portrait (4320×7680). At least 2 frames and at most 2401 frames for 1080p (e.g. about 100 seconds at 24fps, or about 80 seconds at 30fps), 601 frames for 4k (e.g. about 25 seconds at 24fps, or about 20 seconds at 30fps) or 241 frames for 8k (e.g. about 10 seconds at 24fps, or about 8 seconds at 30fps). The frame rate must be at least 1 fps.

resolutionenumRequired

Output size. The output keeps the input’s aspect ratio and is as large as fits 1920×1080 (1080p), 3840×2160 (4k) or 7680×4320 (8k), turned to portrait for a portrait input.

Allowed values:

Response

Job submitted successfully
idstring
Unique job identifier. Use this to poll for status.
created_atdatetime
ISO 8601 timestamp of when the job was created.

Errors

400
Bad Request Error
401
Unauthorized Error
413
Content Too Large Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error