Video Enhance

Astra

Creative video enhancer for upscaling AI-generated videos up to 4K resolution.

post/generate/enhance/topaz/astra

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' | 'high'

How much creative detail Astra adds while enhancing.

video_urlstring uri required

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

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

    • 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