{"api_id":"topaz/topaz-image-upscale/image-upscale","vendor":"topaz","function":"image-upscale","category":"image","name":"Topaz Image Upscale","description":"Upscale and enhance images with Topaz Labs models. One endpoint; the `model` request field picks the enhancement model (Standard V2 by default), priced per image up to 24MP output. The standard family keeps the original flat price; the generative family (redefine, standard-max, wonder, wonder-3, wonder-3.5) adds synthesized detail at a higher rate.","display_pricing":{"components":[{"role":"output","unit":{"type":"image","quantity":1,"included":0},"starting_at":{"spec":{"variant":"standard-v2"},"sell_usd":"0.126","micro_usd":126000},"price_tiers":[{"spec":{"variant":"standard-v2"},"sell_usd":"0.126","micro_usd":126000},{"spec":{"variant":"low-resolution-v2"},"sell_usd":"0.126","micro_usd":126000},{"spec":{"variant":"cgi"},"sell_usd":"0.126","micro_usd":126000},{"spec":{"variant":"high-fidelity-v2"},"sell_usd":"0.126","micro_usd":126000},{"spec":{"variant":"text-refine"},"sell_usd":"0.126","micro_usd":126000},{"spec":{"variant":"wonder-3"},"sell_usd":"0.378","micro_usd":378000},{"spec":{"variant":"wonder-3.5"},"sell_usd":"0.378","micro_usd":378000},{"spec":{"variant":"redefine"},"sell_usd":"0.756","micro_usd":756000},{"spec":{"variant":"standard-max"},"sell_usd":"0.756","micro_usd":756000},{"spec":{"variant":"wonder"},"sell_usd":"0.756","micro_usd":756000}]}]},"call":{"method":"POST","path":"/v1/media/topaz/topaz-image-upscale/image-upscale"},"input_schema":{"additionalProperties":false,"properties":{"image_url":{"description":"URL of the image to upscale.","media_kinds":["image"],"pattern":"^https?://","title":"Image Url","type":"string"},"upscale_factor":{"default":"x2","description":"How much to enlarge the image: 2x, 3x, or 4x the original dimensions.","enum":["x2","x3","x4"],"title":"Upscale Factor","type":"string"},"model":{"default":"standard-v2","description":"Topaz enhancement model. Standard family (true-to-input upscaling): `standard-v2` (default, general purpose), `low-resolution-v2` (small/degraded sources), `cgi` (art and CGI), `high-fidelity-v2` (detail preservation), `text-refine` (text and shapes). Generative family (adds synthesized detail, priced higher): `redefine` (prompt-driven), `standard-max`, `wonder`, `wonder-3`, `wonder-3.5`.","enum":["standard-v2","low-resolution-v2","cgi","high-fidelity-v2","text-refine","redefine","standard-max","wonder","wonder-3","wonder-3.5"],"title":"Model","type":"string"},"output_format":{"anyOf":[{"enum":["jpeg","png"],"type":"string"},{"type":"null"}],"default":null,"description":"Output image format; omitted keeps the provider default (jpeg).","title":"Output Format"},"crop_to_fill":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"When the output aspect ratio differs, crop to fill the output dimensions instead of the default letterboxing.","title":"Crop To Fill"},"subject_detection":{"anyOf":[{"enum":["all","foreground","background"],"type":"string"},{"type":"null"}],"default":null,"description":"Where enhancements are applied; omitted lets Topaz auto-configure.","title":"Subject Detection"},"face_enhancement":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Apply Topaz's face recovery model. When true, `face_enhancement_strength` and `face_enhancement_creativity` are required. Omitted lets Topaz auto-configure.","title":"Face Enhancement"},"face_enhancement_strength":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Face recovery strength (requires face_enhancement=true).","title":"Face Enhancement Strength"},"face_enhancement_creativity":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Realistic (0) to creative (1) face recovery (requires face_enhancement=true).","title":"Face Enhancement Creativity"},"sharpen":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Sharpening strength.","title":"Sharpen"},"denoise":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Denoise strength.","title":"Denoise"},"fix_compression":{"anyOf":[{"maximum":1,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Compression-artifact removal strength (standard models only).","title":"Fix Compression"},"strength":{"anyOf":[{"maximum":1,"minimum":0.01,"type":"number"},{"type":"null"}],"default":null,"description":"Overall model strength (standard models only); too high can look unrealistic.","title":"Strength"},"prompt":{"anyOf":[{"maxLength":1024,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"Describe the desired result for generative models (not wonder-3/wonder-3.5); descriptive statements work better than directives. Cannot be combined with autoprompt=true.","title":"Prompt"},"autoprompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Auto-generate the guidance prompt (generative models except wonder-3/wonder-3.5; replaces `prompt`).","title":"Autoprompt"},"creativity":{"anyOf":[{"maximum":9,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Generative creativity 1-9 (generative models only); lower stays truest to the input.","title":"Creativity"},"texture":{"anyOf":[{"maximum":5,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Generative texture detail 1-5 (generative models only); 1 at low creativity, 3 at higher.","title":"Texture"},"detail":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Add post-render detail (generative models only). When true, `detail_strength` is required.","title":"Detail"},"detail_strength":{"anyOf":[{"maximum":10,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Post-render detail strength (requires detail=true).","title":"Detail Strength"},"enhancement_strength":{"anyOf":[{"enum":["low","medium","high"],"type":"string"},{"type":"null"}],"default":null,"description":"Enhancement level (wonder-3 and wonder-3.5 only); omitted lets Topaz auto-configure.","title":"Enhancement Strength"}},"required":["image_url"],"title":"TopazImageUpscaleRequest","type":"object"}}