topaz/upscale/image
Topaz Labs Image Upscale and Enhancement
Pricing
Adjustments:
Example Pricing:
Input Parameters
Image to enhance
Model to use: Standard V2 (general purpose), Low Resolution V2 (for low-res images), CGI (for digital art), High Fidelity V2 (preserves details), Text Refine (optimized for text)
Default: Standard V2
Options: Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine
Output format
Default: png
Options: jpg, png
How much to upscale the image
Default: None
Options: None, 2x, 4x, 6x
Enhance faces in the image
Default:
Subject detection
Default: All
Options: All, Foreground, Background
Control how sharp the enhanced faces are relative to the background from 0 to 1. Defaults to 0.8, and is ignored if face_enhancement is false.
Default: 0.8
Choose the level of creativity for face enhancement from 0 to 1. Defaults to 0, and is ignored if face_enhancement is false.
Default: 0
Directives
Raw JSON
{
"identifier": "topaz/upscale/image",
"fal_endpoint": "fal-ai/topaz/upscale/image",
"type": "image",
"category": "image-processing",
"description": "Topaz Labs Image Upscale and Enhancement",
"pricing": {
"version": 1,
"base": {
"unit": "image",
"credits": 3
},
"adjustments": [
{
"type": "multiplier_map",
"key": "upscale_factor",
"map": {
"None": 1,
"2x": 1.5,
"4x": 2,
"6x": 3
},
"default": 1
},
{
"type": "multiplier_map",
"key": "enhance_model",
"map": {
"Standard V2": 1,
"Low Resolution V2": 1.2,
"CGI": 1.2,
"High Fidelity V2": 1.4,
"Text Refine": 1.3
},
"default": 1
}
],
"display": {
"min_credits": 5,
"max_credits": 12
}
},
"directives": {
"imageKeys": [
"image"
],
"hiddenKeys": [
"output_format"
],
"advancedKeys": [
"face_enhancement",
"face_enhancement_strength",
"face_enhancement_creativity"
]
},
"fal": {
"input_transforms": [
{
"type": "set_default",
"key": "output_format",
"value": "png"
},
{
"type": "rename",
"from": "image",
"to": "image_url"
},
{
"type": "rename",
"from": "enhance_model",
"to": "model"
},
{
"type": "map",
"key": "upscale_factor",
"map": {
"None": 1,
"1": 1,
"2": 2,
"2x": 2,
"4": 4,
"4x": 4,
"6": 6,
"6x": 6
},
"default": 1
},
{
"type": "map",
"key": "subject_detection",
"map": {
"None": "All"
},
"default": "All"
}
]
},
"inputSchema": {
"type": "object",
"title": "Input",
"required": [
"image"
],
"properties": {
"image": {
"type": "string",
"title": "Image",
"format": "uri",
"x-order": 0,
"description": "Image to enhance"
},
"enhance_model": {
"enum": [
"Standard V2",
"Low Resolution V2",
"CGI",
"High Fidelity V2",
"Text Refine"
],
"type": "string",
"title": "enhance_model",
"description": "Model to use: Standard V2 (general purpose), Low Resolution V2 (for low-res images), CGI (for digital art), High Fidelity V2 (preserves details), Text Refine (optimized for text)",
"default": "Standard V2",
"x-order": 1
},
"output_format": {
"enum": [
"jpg",
"png"
],
"type": "string",
"title": "output_format",
"description": "Output format",
"default": "png",
"x-order": 3
},
"upscale_factor": {
"enum": [
"None",
"2x",
"4x",
"6x"
],
"type": "string",
"title": "upscale_factor",
"description": "How much to upscale the image",
"default": "None",
"x-order": 2
},
"face_enhancement": {
"type": "boolean",
"title": "Face Enhancement",
"default": false,
"x-order": 5,
"description": "Enhance faces in the image"
},
"subject_detection": {
"enum": [
"All",
"Foreground",
"Background"
],
"type": "string",
"title": "subject_detection",
"description": "Subject detection",
"default": "All",
"x-order": 4
},
"face_enhancement_strength": {
"type": "number",
"title": "Face Enhancement Strength",
"default": 0.8,
"maximum": 1,
"minimum": 0,
"x-order": 7,
"description": "Control how sharp the enhanced faces are relative to the background from 0 to 1. Defaults to 0.8, and is ignored if face_enhancement is false."
},
"face_enhancement_creativity": {
"type": "number",
"title": "Face Enhancement Creativity",
"default": 0,
"maximum": 1,
"minimum": 0,
"x-order": 6,
"description": "Choose the level of creativity for face enhancement from 0 to 1. Defaults to 0, and is ignored if face_enhancement is false."
}
}
},
"outputSchema": {
"type": "array",
"title": "Output",
"description": "Array of output objects. Each object contains url, object_key, content_type, etc.",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"object_key": {
"type": "string"
},
"content_type": {
"type": "string"
}
}
}
}
}