zf-kbot/image-upscaler-20251103
Public
6.2M
runs
Run zf-kbot/image-upscaler-20251103 with an API
Use one of our client libraries to get started quickly. Clicking on a library will take you to the Playground tab where you can tweak different inputs, see the results, and copy the corresponding code to use in your own project.
Input schema
The fields you can use to run this model with an API. If you don't give a value for a field its default value will be used.
| Field | Type | Default value | Description |
|---|---|---|---|
| input_image |
string
|
输入图片文件（支持 jpg、png、bmp 格式）
|
|
| processing_mode |
None
|
blur
|
处理模式选择。blur=模糊图片去模糊+增强（≤2K），clear=清晰图片直接增强（支持4K+大图）
|
| max_resolution |
integer
|
1920
Max: 4096 |
[blur模式] 目标最长边尺寸（推荐1280-1920）。图片会等比缩放，处理后自动裁切黑边。0=不调整
|
| output_quality |
integer
|
0
Max: 4 |
[blur模式] SeedVR2 输出质量预设。0=使用FlashVSR输出分辨率（推荐），2=2K(2560×1440)，4=4K(3840×2160，需更多显存）
|
| tile_size |
integer
|
2048
Min: 1024 Max: 4096 |
[clear模式] 分块尺寸（像素）。推荐2048。更大的tile需要更多显存
|
| target_scale |
integer
|
0
Max: 4 |
[clear模式] 目标放大倍数。0=保持原分辨率，2=放大到2倍（4块），3=3倍（9块），4=4倍（16块）
|
| output_format |
None
|
jpg
|
输出图片格式。jpg=压缩率高，png=无损
|
| enable_4x_upscale |
integer
|
0
Max: 1 |
启用 4x 超分辨率放大（使用 ClearRealityV1 模型）。0=禁用，1=启用
|
| quality_limit |
integer
|
0
Max: 4096 |
[高级-blur模式] SeedVR2 最短边上限（0=使用预设）。用于限制显存占用
|
| oom_prevention_threshold |
number
|
1.5
Min: 1 Max: 4 |
[高级-blur模式] 长宽比阈值（OOM预防）。当图片长宽比<此值时，自动降低分辨率。推荐1.5
|
| oom_fallback_resolution |
integer
|
1280
Min: 128 Max: 2560 |
[高级-blur模式] OOM 时降级分辨率。推荐1280
|
| tile_overlap |
integer
|
64
Max: 256 |
[高级-clear模式] 分块重叠区域（像素）。用于平滑拼接，推荐64
|
| tile_memory_mode |
integer
|
1
Max: 1 |
[高级-clear模式] 分块显存优化。0=禁用，1=启用（将tile缩小到1280处理，节省显存）
|
| tile_sharpening |
number
|
0.8
Max: 2 |
[高级-clear模式] 分块预处理锐化强度。推荐0.8
|
| final_sharpening |
number
|
0.3
Max: 2 |
[高级-clear模式] 最终锐化强度（拼接后）。推荐0.3
|
| extra_scale |
number
|
1
Min: 1 Max: 4 |
[高级] 额外放大倍率（在分辨率调整后）。通常保持1.0
|
| log_level |
None
|
info
|
[高级] 日志详细程度。info=基本信息，debug=详细调试
|
{
"type": "object",
"title": "Input",
"required": [
"input_image"
],
"properties": {
"log_level": {
"enum": [
"info",
"debug"
],
"type": "string",
"title": "log_level",
"description": "[\u9ad8\u7ea7] \u65e5\u5fd7\u8be6\u7ec6\u7a0b\u5ea6\u3002info=\u57fa\u672c\u4fe1\u606f\uff0cdebug=\u8be6\u7ec6\u8c03\u8bd5",
"default": "info",
"x-order": 16
},
"tile_size": {
"type": "integer",
"title": "Tile Size",
"default": 2048,
"maximum": 4096,
"minimum": 1024,
"x-order": 4,
"description": "[clear\u6a21\u5f0f] \u5206\u5757\u5c3a\u5bf8\uff08\u50cf\u7d20\uff09\u3002\u63a8\u83502048\u3002\u66f4\u5927\u7684tile\u9700\u8981\u66f4\u591a\u663e\u5b58"
},
"extra_scale": {
"type": "number",
"title": "Extra Scale",
"default": 1,
"maximum": 4,
"minimum": 1,
"x-order": 15,
"description": "[\u9ad8\u7ea7] \u989d\u5916\u653e\u5927\u500d\u7387\uff08\u5728\u5206\u8fa8\u7387\u8c03\u6574\u540e\uff09\u3002\u901a\u5e38\u4fdd\u63011.0"
},
"input_image": {
"type": "string",
"title": "Input Image",
"format": "uri",
"x-order": 0,
"description": "\u8f93\u5165\u56fe\u7247\u6587\u4ef6\uff08\u652f\u6301 jpg\u3001png\u3001bmp \u683c\u5f0f\uff09"
},
"target_scale": {
"type": "integer",
"title": "Target Scale",
"default": 0,
"maximum": 4,
"minimum": 0,
"x-order": 5,
"description": "[clear\u6a21\u5f0f] \u76ee\u6807\u653e\u5927\u500d\u6570\u30020=\u4fdd\u6301\u539f\u5206\u8fa8\u7387\uff0c2=\u653e\u5927\u52302\u500d\uff084\u5757\uff09\uff0c3=3\u500d\uff089\u5757\uff09\uff0c4=4\u500d\uff0816\u5757\uff09"
},
"tile_overlap": {
"type": "integer",
"title": "Tile Overlap",
"default": 64,
"maximum": 256,
"minimum": 0,
"x-order": 11,
"description": "[\u9ad8\u7ea7-clear\u6a21\u5f0f] \u5206\u5757\u91cd\u53e0\u533a\u57df\uff08\u50cf\u7d20\uff09\u3002\u7528\u4e8e\u5e73\u6ed1\u62fc\u63a5\uff0c\u63a8\u835064"
},
"output_format": {
"enum": [
"jpg",
"png"
],
"type": "string",
"title": "output_format",
"description": "\u8f93\u51fa\u56fe\u7247\u683c\u5f0f\u3002jpg=\u538b\u7f29\u7387\u9ad8\uff0cpng=\u65e0\u635f",
"default": "jpg",
"x-order": 6
},
"quality_limit": {
"type": "integer",
"title": "Quality Limit",
"default": 0,
"maximum": 4096,
"minimum": 0,
"x-order": 8,
"description": "[\u9ad8\u7ea7-blur\u6a21\u5f0f] SeedVR2 \u6700\u77ed\u8fb9\u4e0a\u9650\uff080=\u4f7f\u7528\u9884\u8bbe\uff09\u3002\u7528\u4e8e\u9650\u5236\u663e\u5b58\u5360\u7528"
},
"max_resolution": {
"type": "integer",
"title": "Max Resolution",
"default": 1920,
"maximum": 4096,
"minimum": 0,
"x-order": 2,
"description": "[blur\u6a21\u5f0f] \u76ee\u6807\u6700\u957f\u8fb9\u5c3a\u5bf8\uff08\u63a8\u83501280-1920\uff09\u3002\u56fe\u7247\u4f1a\u7b49\u6bd4\u7f29\u653e\uff0c\u5904\u7406\u540e\u81ea\u52a8\u88c1\u5207\u9ed1\u8fb9\u30020=\u4e0d\u8c03\u6574"
},
"output_quality": {
"type": "integer",
"title": "Output Quality",
"default": 0,
"maximum": 4,
"minimum": 0,
"x-order": 3,
"description": "[blur\u6a21\u5f0f] SeedVR2 \u8f93\u51fa\u8d28\u91cf\u9884\u8bbe\u30020=\u4f7f\u7528FlashVSR\u8f93\u51fa\u5206\u8fa8\u7387\uff08\u63a8\u8350\uff09\uff0c2=2K(2560\u00d71440)\uff0c4=4K(3840\u00d72160\uff0c\u9700\u66f4\u591a\u663e\u5b58\uff09"
},
"processing_mode": {
"enum": [
"blur",
"clear"
],
"type": "string",
"title": "processing_mode",
"description": "\u5904\u7406\u6a21\u5f0f\u9009\u62e9\u3002blur=\u6a21\u7cca\u56fe\u7247\u53bb\u6a21\u7cca+\u589e\u5f3a\uff08\u22642K\uff09\uff0cclear=\u6e05\u6670\u56fe\u7247\u76f4\u63a5\u589e\u5f3a\uff08\u652f\u63014K+\u5927\u56fe\uff09",
"default": "blur",
"x-order": 1
},
"tile_sharpening": {
"type": "number",
"title": "Tile Sharpening",
"default": 0.8,
"maximum": 2,
"minimum": 0,
"x-order": 13,
"description": "[\u9ad8\u7ea7-clear\u6a21\u5f0f] \u5206\u5757\u9884\u5904\u7406\u9510\u5316\u5f3a\u5ea6\u3002\u63a8\u83500.8"
},
"final_sharpening": {
"type": "number",
"title": "Final Sharpening",
"default": 0.3,
"maximum": 2,
"minimum": 0,
"x-order": 14,
"description": "[\u9ad8\u7ea7-clear\u6a21\u5f0f] \u6700\u7ec8\u9510\u5316\u5f3a\u5ea6\uff08\u62fc\u63a5\u540e\uff09\u3002\u63a8\u83500.3"
},
"tile_memory_mode": {
"type": "integer",
"title": "Tile Memory Mode",
"default": 1,
"maximum": 1,
"minimum": 0,
"x-order": 12,
"description": "[\u9ad8\u7ea7-clear\u6a21\u5f0f] \u5206\u5757\u663e\u5b58\u4f18\u5316\u30020=\u7981\u7528\uff0c1=\u542f\u7528\uff08\u5c06tile\u7f29\u5c0f\u52301280\u5904\u7406\uff0c\u8282\u7701\u663e\u5b58\uff09"
},
"enable_4x_upscale": {
"type": "integer",
"title": "Enable 4X Upscale",
"default": 0,
"maximum": 1,
"minimum": 0,
"x-order": 7,
"description": "\u542f\u7528 4x \u8d85\u5206\u8fa8\u7387\u653e\u5927\uff08\u4f7f\u7528 ClearRealityV1 \u6a21\u578b\uff09\u30020=\u7981\u7528\uff0c1=\u542f\u7528"
},
"oom_fallback_resolution": {
"type": "integer",
"title": "Oom Fallback Resolution",
"default": 1280,
"maximum": 2560,
"minimum": 128,
"x-order": 10,
"description": "[\u9ad8\u7ea7-blur\u6a21\u5f0f] OOM \u65f6\u964d\u7ea7\u5206\u8fa8\u7387\u3002\u63a8\u83501280"
},
"oom_prevention_threshold": {
"type": "number",
"title": "Oom Prevention Threshold",
"default": 1.5,
"maximum": 4,
"minimum": 1,
"x-order": 9,
"description": "[\u9ad8\u7ea7-blur\u6a21\u5f0f] \u957f\u5bbd\u6bd4\u9608\u503c\uff08OOM\u9884\u9632\uff09\u3002\u5f53\u56fe\u7247\u957f\u5bbd\u6bd4<\u6b64\u503c\u65f6\uff0c\u81ea\u52a8\u964d\u4f4e\u5206\u8fa8\u7387\u3002\u63a8\u83501.5"
}
}
}
Output schema
The shape of the response you’ll get when you run this model with an API.
Schema
{
"type": "string",
"title": "Output",
"format": "uri"
}