Sign in
Video Enhance

Topaz Video

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

post/generate/enhance/topaz/video-upscale

Headers

X-Webhook-URLstring uri

URL to receive a POST request when the job completes. The webhook will receive the job data including results.

Request body

target_widthnumber

Output width in pixels. Defaults to the source video width.

target_heightnumber

Output height in pixels. Defaults to the source video height.

crop_to_fitboolean

Crop the video to fill the target dimensions instead of preserving the source aspect ratio.

video_urlstring uri required

Can be an external URL, base64 data URI, or uploaded asset URL.

enhancementboolean

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_compressionnumber

Revert compression artifacts (Manual only).

enhancement_recover_detailsnumber

Recover original detail (Manual only).

enhancement_sharpennumber

Sharpen amount (Manual only).

enhancement_reduce_noisenumber

Noise reduction (Manual only).

enhancement_reduce_halonumber

Halo reduction (Manual only).

enhancement_preblurnumber

Anti-alias / deblur strength (Manual only).

frame_interpolationboolean

Interpolate extra frames to raise the output frame rate.

frame_interpolation_fpsinteger

Target output frame rate (frame interpolation only).

frame_interpolation_model'apo-8' | 'apf-2' | 'chr-2' | 'chf-3'

Frame interpolation model.

frame_interpolation_slowmointeger

Slow-motion factor, 1 keeps the original speed (frame interpolation only).

frame_interpolation_fix_duplicate_framesboolean

Detect and drop duplicate frames before interpolating.

frame_interpolation_duplicate_sensitivitynumber

Sensitivity of duplicate-frame detection (only when fix duplicate frames is on).

grainboolean

Add artificial film grain.

grain_strengthnumber

Film grain strength (grain only).

grain_sizenumber

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

The resulting job data. This will be returned in a pending state until the job is completed. See /jobs/{id} for retrieving the results.

job_idstring uuid required
status'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled' required
created_atstring date-time required
{"stackTrail":"paths:/generate/enhance/topaz/video-upscale:post:responses:200:content:application/json:schema:properties:completed_at","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/generate/enhance/topaz/video-upscale:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}

Changes

Changed in 1 of the 53 revisions of this API.1

  • 27a8a554d4fd1See the full diff
    • ○

      the response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status

      response-property-pattern-changed