> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoox.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Hoox Upscale

> Hoox · `hoox-upscale` · video

Raises a video to a target resolution and frame rate, keeping its audio. Hoox picks the engine: frame interpolation (RIFE) when only the frame rate goes up, the ByteDance upscaler when the resolution does. The output never goes below the source resolution, and a request that changes nothing is rejected. Billed per second of source video, at the output resolution and frame rate.

## Identifier

Use the model identifier `hoox-upscale` in the `model` field when calling [`/asset/start`](/api-reference/assets/start). This model takes no `prompt`.

## Capabilities

| Property | Value |
| - | - |
| Reference inputs | 1 |
| Input types | `video` |
| Resolutions | `1080p`, `2k`, `4k` (default `1080p`) |
| Audio | yes |
| Tags | `upscale` |

## Inputs

This model takes **named media inputs**. Pass each one as a top-level field in the request body. Each field accepts exactly one of `url`, `asset_id`, or `avatar_id`.

| Field | Type | Required | Description |
| - | - | - | - |
| `source_video` | video | yes | Video to upscale. Its resolution, frame rate and duration are read from the file. |

* `url` — a direct, publicly accessible file URL
* `asset_id` — the ID of an existing asset in your Hoox space (e.g. a previous generation)
* `avatar_id` — the ID of an avatar defined in your Hoox space

A positional `references` array is also accepted, mapped onto the slots in the order above.

## Custom settings

These keys go inside the `model_settings` object of the request body.

| Key | Type | Default | Affects cost | Description |
| - | - | - | - | - |
| `fps` | select | `60` | yes | Output frame rate. When the resolution does not go up, it must be above the source frame rate. Options: `30`, `60`, `120`. |

## Pricing

Billed per second of source video, in credits, at the output resolution and frame rate. The output resolution is never below the source's.

| Resolution | 30 fps | 60 fps | 120 fps |
| - | - | - | - |
| `1080p` | 0.072 | 0.144 | 0.288 |
| `2k` | 0.144 | 0.288 | 0.576 |
| `4k` | 0.288 | 0.576 | 1.152 |

For exact pricing with your own parameters, call [`/asset/pricing`](/api-reference/assets/pricing) with the `model` and any parameters that affect cost.

## Example request

```json theme={null}
{
  "type": "video",
  "model": "hoox-upscale",
  "source_video": {
    "url": "https://example.com/reference.mp4"
  },
  "resolution": "1080p"
}
```

See [`/asset/start`](/api-reference/assets/start) for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.