Sign in

v12

latestOpenAPI 3.1.02026-08-031000506.8 KB
Video Enhance

Astra 2

Creative diffusion-based video upscaler with prompt guidance, creativity, and sharpness controls. Max 4K.

post/generate/enhance/topaz/astra-2

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.

creativity'low' | 'middle' | 'high'

How much creative detail Astra 2 adds while enhancing.

sharpnumber

Sharpening strength (0 to 1).

realismnumber

Realism strength (0 to 1); higher pushes toward photoreal detail.

video_urlstring uri required

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

promptstring

Optional prompt guiding the enhancement.

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).

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/astra-2:post:responses:200:content:application/json:schema:properties:completed_at","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/generate/enhance/topaz/astra-2:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}