---
title: "Topaz Video"
method: POST
path: "/generate/enhance/topaz/video-upscale"
tags: ["Video Enhance"]
---

# Topaz Video

`POST /generate/enhance/topaz/video-upscale`

Topaz's powerful AI upscaler. Add frames and grain, fix focus, and more. Max 8K.

## Headers

- `X-Webhook-URL` string, uri

## Request body

- object
  - `target_width` number — Output width in pixels. Defaults to the source video width.
  - `target_height` number — Output height in pixels. Defaults to the source video height.
  - `crop_to_fit` boolean — Crop the video to fill the target dimensions instead of preserving the source aspect ratio.
  - `video_url` string, uri, required — Can be an external URL, base64 data URI, or uploaded asset URL.
  - `enhancement` boolean — Run the Topaz enhancement (upscaling / cleanup) pass.
  - `enhancement_video_type` 'Progressive' | 'Interlaced' | 'ProgressiveInterlaced' — Whether the source is progressive, interlaced, or mixed.
  - `enhancement_model` 'aaa-9' | 'ahq-12' | 'alq-13' | 'alqs-2' | 'amq-13' | 'amqs-2' | 'ddv-3' | 'dtd-4' | 'dtds-2' | 'dtv-4' | 'dtvs-2' | 'gcg-5' | 'ghq-5' | 'iris-2' | 'iris-3' | 'nxf-1' | 'nyx-3' | 'prob-4' | 'rhea-1' | 'sl-1' | 'thd-3' | 'thf-4' | 'thm-2' — Enhancement AI model. Valid options depend on the video type (Progressive — Artemis, Gaia, Iris, Nyx, Proteus, Rhea, Theia; Interlaced — Dione DV, Dione TV, Dione Dehalo, Iris LQ, Iris MQ, Proteus; Progressive + Interlaced — Dione Robust, Dione Robust Dehalo, Iris LQ, Iris MQ, Proteus).
  - `enhancement_focus_fix` 'None' | 'Normal' | 'Strong' — Focus correction strength applied to blurry footage.
  - `enhancement_parameters` 'Auto' | 'Manual' — `Auto` lets the AI pick settings; `Manual` uses the sliders below.
  - `enhancement_compression` number — Revert compression artifacts (Manual only).
  - `enhancement_recover_details` number — Recover original detail (Manual only).
  - `enhancement_sharpen` number — Sharpen amount (Manual only).
  - `enhancement_reduce_noise` number — Noise reduction (Manual only).
  - `enhancement_reduce_halo` number — Halo reduction (Manual only).
  - `enhancement_preblur` number — Anti-alias / deblur strength (Manual only).
  - `frame_interpolation` boolean — Interpolate extra frames to raise the output frame rate.
  - `frame_interpolation_fps` integer — Target output frame rate (frame interpolation only).
  - `frame_interpolation_model` 'apo-8' | 'apf-2' | 'chr-2' | 'chf-3' — Frame interpolation model.
  - `frame_interpolation_slowmo` integer — Slow-motion factor, 1 keeps the original speed (frame interpolation only).
  - `frame_interpolation_fix_duplicate_frames` boolean — Detect and drop duplicate frames before interpolating.
  - `frame_interpolation_duplicate_sensitivity` number — Sensitivity of duplicate-frame detection (only when fix duplicate frames is on).
  - `grain` boolean — Add artificial film grain.
  - `grain_strength` number — Film grain strength (grain only).
  - `grain_size` number — Film grain particle size (grain only).
  - `video_output_preset` 'h264-high' | 'h265-main' | 'h265-main10' | 'prores-422-proxy' | 'prores-422-lt' | 'prores-422-std' | 'prores-422-hq' | 'av1-8-bit' | 'av1-10-bit' | 'vp9-good' | 'vp9-best' — Output encoder profile: codec, container, and bit depth.

## Response `200`

The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.

- object
  - `job_id` string, uuid, required
  - `status` 'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled', required
  - `created_at` string, date-time, required
  - `completed_at` unknown, required
  - `result` unknown, required
  - `error` object
    - `code` string, required
    - `message` string

## Other responses

- `400` — The request body is invalid.
- `401` — You are not authenticated.
- `402` — You have run out of credits.
- `429` — You have reached the maximum number of concurrent jobs.

---

[API](https://skmtc.net/krea/apis/krea-api.md) · [All operations](https://skmtc.net/krea/apis/krea-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/krea/krea-api/revisions/5654aa0aa524/schema)