Image Upscaler Collection API
来自五家提供商的十个图像超分辨率端点——WaveSpeedAI(Standard、Ultimate、Real-ESRGAN)、Clarity AI(Creative、Crystal、Flux、Pro)、Recraft(Creative、Crisp)和 Pruna AI——全部通过一个 WaveSpeedAI API 密钥调用。可按目标分辨率(最高 16 倍)、风格保留、提示词引导的精修或单次调用成本来选择。
五家提供商共十个端点。放大倍率从轻度的纹理细节处理(Recraft)到最高 16 倍的写实放大(Clarity AI Pro)。大批量目录工作可使用成本优化的变体;当源图质量或身份保留很重要时,可选用更大的架构。整个系列的请求格式相同;一个计费账户,一套速率限制。
/filters:quality(82)/examples/8b4282a748d8406998e4d8cc2f43d809/1783677263110569046_IHFsrf3S.webp)
概览
关于 Image Upscaler Collection API
Image Upscaler Collection 能做什么、它在 WaveSpeedAI 模型阵容中的定位,以及团队选择它的原因。
Image Upscaler Collection 是 WaveSpeedAI 推出的AI 放大模型,可通过 WaveSpeedAI REST API 使用。来自五家提供商的十个图像超分辨率端点——WaveSpeedAI(Standard、Ultimate、Real-ESRGAN)、Clarity AI(Creative、Crystal、Flux、Pro)、Recraft(Creative、Crisp)和 Pruna AI——全部通过一个 WaveSpeedAI API 密钥调用。可按目标分辨率(最高 16 倍)、风格保留、提示词引导的精修或单次调用成本来选择。
五家提供商共十个端点。放大倍率从轻度的纹理细节处理(Recraft)到最高 16 倍的写实放大(Clarity AI Pro)。大批量目录工作可使用成本优化的变体;当源图质量或身份保留很重要时,可选用更大的架构。整个系列的请求格式相同;一个计费账户,一套速率限制。
WaveSpeedAI 上的 Image Upscaler Collection 系列提供 9 个 REST 端点,涵盖 Upscale-Image, Image-To-Image 个工作流。每个变体都有各自的定价、参数选项和示例输出——请选择与你的输入模态和生产约束相匹配的那一个,或使用同一个 API 密钥调用多个变体,组合成多步骤流水线。
使用与 WaveSpeedAI 上其他 1,000 多个 AI 模型相同的 API 密钥、账单账户和速率限制来运行 Image Upscaler Collection。无需单独对接供应商,无需各家 SDK,也无需应对各家不同的速率限制——一次集成即可覆盖从文生图、文生视频到音频合成、3D 生成、放大和编辑的全部能力。
端点
全部 Image Upscaler Collection API 端点
WaveSpeedAI 现已提供 9 个 Image Upscaler Collection 端点——请选择适合你工作流的变体。
/filters:quality(82)/media/images/20260408112243_fhp8ohcz.webp)
Image Upscaler
AI Image Upscaler that enhances image resolution to 4K or 8K while improving detail and clarity for photos and graphics. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408105856_xdkgwc0r.webp)
Ultimate Image Upscaler
Ultimate Image Upscaler is the most advanced AI enhancer that reimagines fine detail while upscaling images to 4K or 8K. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112755_7xf0vr3f.webp)
Creative Upscaler
Creative Upscaler enlarges images with style and detail control, restoring photos or adding micro-textures for portraits and anime. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112749_sskkultw.webp)
Crystal Upscaler
Clarity AI Crystal Upscaler boosts image resolution with AI upscaling and adjustable detail for portraits and landscapes. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112745_ly28ul0x.webp)
Flux Upscaler
Clarity AI Flux Upscaler sharpens images while preserving natural textures and edges, with prompt-guided refinement and LoRA support. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1778336970674857900_o88kuF5y.webp)
Pro Upscaler
Clarity Pro Upscaler is a photorealistic image upscaler from Clarity AI with identity preservation, creative detail control, and up to 16x scaling. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408105329_hz4ngu75.webp)
Recraft Creative Upscale
Recraft Creative Upscale refines textures and fine details, adding depth and polish to complex elements—not increasing resolution. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408105300_p2s9eq1d.webp)
Recraft Crisp Upscale
Recraft Crisp Upscale enhances textures, fine details, and facial features to add depth beyond simple resolution boosts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/1778523360937396018_4D2cMW5f.webp)
P Image Upscale
Pruna AI P-Image Upscale is a fast AI image upscaling model that enhances image resolution and improves visual detail. Ready-to-use REST inference API for product photos, portraits, design assets, e-commerce images, social media visuals, and image enhancement workflows with simple integration, no coldstarts, and affordable pricing.
示例
看看 Image Upscaler Collection 的实际效果
由 Image Upscaler Collection API 生成的真实输出。悬停在任意视频上即可预览,点击可打开全尺寸查看器。
使用方法
如何使用 Image Upscaler Collection API
从注册到完成一次生成,只需四步。完整的 Python、Node.js 和 cURL 示例见下方的 API 部分。
- 01
获取 API 密钥
注册 WaveSpeedAI 账号,并从控制台复制你的 API 密钥。新账号附带免费体验额度——足够在开始计费前把 Playground 运行几十次。
- 02
提交预测
把你的输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/wavespeed-ai/image-upscaler。端点会立即返回预测 ID——生成是异步的,因此推理期间你无需保持连接。
- 03
轮询完成状态
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。状态为 completed 时返回输出;状态为 failed、cancelled、timeout 或 deleted 时以错误终止;其他任何状态都继续轮询。
- 04
读取输出 URL
状态变为 "completed" 后,从 data.outputs[0] 读取 URL。该 URL 指向 WaveSpeedAI CDN 上你生成的媒体——具体是图片、视频、音频还是 3D 文件,取决于你调用的 Image Upscaler Collection 变体。
应用场景
用 Image Upscaler Collection 可以构建什么
开发者和创作者使用 Image Upscaler Collection API 的常见工作流。
AI 生成图像的后处理
大多数 AI 图像模型原生输出为 1K-2K。wavespeed-ai/image-upscaler 是默认的 2×/4× 后处理,可将生成结果提升到交付分辨率。需要更高保真度时,可切换到 wavespeed-ai/ultimate-image-upscaler——请求格式相同,单次调用更慢,但输出更干净。
用 Clarity Pro 实现写实 16 倍放大
clarity-ai/pro-upscaler 可实现最高 16 倍的写实超分辨率,保留身份并可控制创意细节——这是整个系列中最高的放大倍率。适合肖像、档案电影剧照,以及需要大幅放大又不能丢失主体身份的素材。
提示词引导的精修(Clarity Flux)
clarity-ai/flux-upscaler 在保留自然纹理和边缘的同时锐化图像,支持提示词引导的精修和 LoRA——这是整个系列中唯一在源图像之外还接受文本提示词的端点,适合希望在放大过程中控制风格的场景。
创意细节控制(Clarity Creative + Crystal)
clarity-ai/creative-upscaler 可修复照片或为肖像和动漫添加微纹理;clarity-ai/crystal-upscaler 可在提升分辨率的同时调节细节,适用于肖像和风景。当希望部分细节由合成而非纯粹还原得到时,请选择它们。
不改变分辨率的纹理润色(Recraft)
recraft-ai/recraft-creative-upscale 和 recraft-ai/recraft-crisp-upscale 精修纹理、细节和面部特征——它们增加的是层次感和质感,而不是大幅提高分辨率。适合源图已经达到目标分辨率、但仍需要锐度和材质保真度的情况。
带人脸修复的 Real-ESRGAN
wavespeed-ai/real-esrgan 提供高质量超分辨率,可选人脸修复并可调节放大倍率——经典的开源放大架构,以 REST 端点托管,无需自行部署 GPU 的开销。
成本优化的批量流水线(Pruna)
pruna-ai/p-image/upscale 是快速、成本优化的图像放大器——适用于大批量清理流水线,比如放大每一张目录照片或每一张 AI 生成的缩略图,且不需要更大架构的保真度上限。
电商目录图像
将产品摄影放大到 4K,以适配视网膜屏幕和缩放视图。成本优化的批量目录处理可用 wavespeed-ai/image-upscaler 或 pruna-ai/p-image/upscale;产品材质保真度比绝对分辨率更重要时,用 recraft-ai/recraft-crisp-upscale。
照片修复与档案
将老照片、低分辨率或压缩过的照片提升到 4K/8K,用于个人档案、博物馆数字化和历史内容发布。需要保留身份的肖像用 clarity-ai/pro-upscaler;希望合成微纹理时用 clarity-ai/creative-upscaler;档案肖像使用带人脸修复的 wavespeed-ai/real-esrgan。
印刷和大幅面输出准备
为海报、广告牌或印刷输出准备图像——在保留细节的同时提升到 4K 或 8K。高端交付可用 wavespeed-ai/ultimate-image-upscaler 或 clarity-ai/pro-upscaler;大批量产品图处理则用成本优化的档位。
技巧
Image Upscaler Collection 提示词技巧
让 Image Upscaler Collection 输出更好结果的实用建议——总结自生产流水线中各类放大模型都适用的做法。
- 01
按素材类型选择模型,而不只是目标分辨率
AI 生成的素材 → wavespeed-ai/image-upscaler 或 wavespeed-ai/ultimate-image-upscaler。肖像 / 身份至关重要 → clarity-ai/pro-upscaler(16 倍并保留身份)或 wavespeed-ai/real-esrgan(人脸修复)。提示词引导的精修 → clarity-ai/flux-upscaler。不改变分辨率的纹理润色 → recraft-ai/*。批量目录清理 → pruna-ai/p-image/upscale。
- 02
选择满足目标的最小放大倍率
2 倍是大多数素材的最佳平衡点。4 倍会放大源图中的任何压缩伪影。8 倍和 16 倍仅适用于广告牌 / 大幅面 / 肖像放大——在成本优化的模型上,超过 4 倍后收益递减,而 clarity-ai/pro-upscaler 是专为更高倍率调优的模型。
- 03
源图越干净,输出越干净
无论选择哪个模型,源图中严重的压缩都会在放大中被放大。如果能拿到原始文件(TIFF、相机原始文件、无损 PNG),请用它作为输入——系列中的每个放大器在更干净的素材上表现都更好。
- 04
想要风格控制时使用 Clarity Flux
clarity-ai/flux-upscaler 是整个系列中唯一在源图像之外还接受文本提示词 + LoRA 的端点。适合想通过放大来引导风格(「更清晰、更接近摄影、更少动漫感」),而不是被动还原细节的场景。
- 05
成本优化的批量处理使用 Pruna 或 Standard
pruna-ai/p-image/upscale 和 wavespeed-ai/image-upscaler 是成本优化的档位——适合大批量放大(每一张 AI 生成的缩略图、每一张目录照片)。交付级输出请留给 Ultimate / Clarity Pro / 带人脸修复的 Real-ESRGAN。
- 06
融入 AI 生成的交付流水线
大多数 AI 图像模型原生输出为 1K-2K。可将放大器作为 2 倍或 4 倍的后处理,把生成结果提升到交付分辨率。标准流水线:生成 → 放大 → 导出,作为一次批量操作运行,并按每个镜头的需求在本系列端点之间选择。
- 07
重新导出为合适的格式
放大之后,请重新编码为下游所需的格式——网页交付用 JPEG,需要透明用 PNG,印刷用 TIFF。各放大器的原始输出通常没有问题;如果编码草率,画质损失就会出在这一步。
定价
Image Upscaler Collection API 定价
按输出计费。最终费用会随你在各变体 Playground 中设置的参数(分辨率、时长、输出数量、参考素材)而变化。
| 端点 | 类型 | 起步价 |
|---|---|---|
| wavespeed-ai/ | upscale-image | $0.01 |
| wavespeed-ai/ | upscale-image | $0.06 |
| clarity-ai/ | upscale-image | $0.05 |
| clarity-ai/ | upscale-image | $0.03 |
| clarity-ai/ | upscale-image | $0.20 |
| clarity-ai/ | upscale-image | $0.03 |
| recraft-ai/ | image-to-image | $0.25 |
| recraft-ai/ | upscale-image | $0.004 |
| pruna-ai/ | upscale-image | $0.005 |
API
调用 Image Upscaler Collection API
在 wavespeed.ai/accesskey 注册并获取 API 密钥,然后通过 REST 提交预测。Playground 可以为任意输入组合生成可直接粘贴的示例代码。
POSThttps://api.wavespeed.ai/api/v3/wavespeed-ai/image-upscaler
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/image-upscaler" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"target_resolution": "4k",
"output_format": "jpeg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/wavespeed-ai/image-upscaler";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"target_resolution": "4k",
"output_format": "jpeg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"target_resolution": "4k",
"output_format": "jpeg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/wavespeed-ai/image-upscaler", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)对比
Image Upscaler Collection 与其他方案对比
在 WaveSpeedAI 上,何时应选择 Image Upscaler Collection 而不是同类模型。
Image Upscaler Collection 对比 Topaz Gigapixel
Topaz Gigapixel 是桌面应用,按席位授权,并需要本地 GPU。Image Upscaler 系列是 REST API,提供十种模型选择——更适合云端流水线、批处理任务和 SaaS 集成,并可在成本与保真度之间灵活选择档位。
Image Upscaler Collection 对比 Self-hosted Real-ESRGAN
Real-ESRGAN 是开源的——您可以用自己的 GPU 基础设施自行部署。wavespeed-ai/real-esrgan 将同一模型作为托管端点提供,省去了基础设施开销;把 GPU 实例时间和运维投入算进去,通常总成本更低。
Image Upscaler Collection 对比 Magnific AI
Magnific 是用于交互式使用的网页应用。本系列以 API 为先——更适合批量操作、自动化流水线和 SaaS 集成。clarity-ai/pro-upscaler 覆盖了 Magnific 所主打的 16 倍写实放大场景,并按 API 价格计费。
Image Upscaler Collection 对比 Single-model upscaler pipeline
把流水线绑定到单一图像放大器,意味着无法在成本与保真度之间选择档位,容量不足时没有备选,也无法按素材类型选择模型。十个可互换的端点让您可以按素材(AI 生成 / 肖像 / 档案)、目标倍率(2× 至 16×)或单次调用成本进行路由,而无需重写下游代码。
常见问题
Image Upscaler Collection API — 常见问题
定价、许可、集成——关于在 WaveSpeedAI 上运行 Image Upscaler Collection 的常见问题。
Image Upscaler Collection API 是什么?
Image Upscaler Collection 是 WaveSpeedAI 的upscaler模型,在 WaveSpeedAI 上以 REST API 形式提供。来自五家提供商的十个图像超分辨率端点——WaveSpeedAI(Standard、Ultimate、Real-ESRGAN)、Clarity AI(Creative、Crystal、Flux、Pro)、Recraft(Creative、Crisp)和 Pruna AI——全部通过一个 WaveSpeedAI API 密钥调用。可按目标分辨率(最高 16 倍)、风格保留、提示词引导的精修或单次调用成本来选择。你可以通过编程方式调用它,也可以在上方链接的 Playground 中试用。
如何调用 Image Upscaler Collection API?
注册 WaveSpeedAI 账号,从 /accesskey 复制你的 API 密钥,然后把输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/wavespeed-ai/image-upscaler。端点会返回预测 ID。从大约每 2 秒一次开始轮询结果端点,长耗时任务可适当拉长间隔,并在任何终止状态时停止。上方有面向生产环境的 Python / Node.js / cURL 示例。
Image Upscaler Collection API 的费用是多少?
Image Upscaler Collection 每次调用 $0.004 起。实际费用会随你设置的参数(分辨率、时长、输出数量、参考素材)而变化。Playground 中“生成”按钮旁的实时费用预览会显示你当前输入对应的准确价格。
有哪些 Image Upscaler Collection 变体可用?
WaveSpeedAI 托管了 9 个已上线的 Image Upscaler Collection 端点:wavespeed-ai/image-upscaler, wavespeed-ai/ultimate-image-upscaler, clarity-ai/creative-upscaler, clarity-ai/crystal-upscaler, clarity-ai/flux-upscaler, clarity-ai/pro-upscaler, recraft-ai/recraft-creative-upscale, recraft-ai/recraft-crisp-upscale等。每个变体都有自己的 Playground 页面和定价。
Image Upscaler Collection 的输出可以商用吗?
商用权利遵循 WaveSpeedAI 的模型许可。大多数 WaveSpeedAI 模型允许商用输出;具体许可摘要请查看各模型的 Playground 页面,平台层面的条件请参阅 WaveSpeedAI 的服务条款。
为什么要在 WaveSpeedAI 上使用 Image Upscaler Collection,而不是直接对接?
一个 API 密钥、一个账单账户,即可使用 Image Upscaler Collection 以及来自其他提供方的 1,000 多个 AI 模型。无需逐家配置 SDK,无需应对各自独立的速率限制,也无需为每家重写集成代码。价格通常与 WaveSpeedAI 直接提供的 API 持平或更低。
提供方
关于 WaveSpeedAI
Image Upscaler Collection 及 WaveSpeedAI 上 WaveSpeedAI 更多模型背后的团队。
WaveSpeedAI 运营着一个推理平台,托管来自所有主流提供商——字节跳动、Google、OpenAI、阿里巴巴、快手、ElevenLabs 以及数十家独立实验室——的 1,000+ AI 模型,只需一个 API 密钥、一个计费账户和一套速率限制。WaveSpeedAI 还提供自有模型(图像 / 视频放大、水印消除、Animate、InfiniteTalk),专为生产流水线调优。
在 WaveSpeedAI 上用 Image Upscaler Collection 开始构建
注册即送免费体验额度。一个 API 密钥,即可使用来自 WaveSpeedAI 及其他所有提供方的 1,000 多个 AI 模型。
/filters:quality(82)/examples/44a7ae44532541c2b425f6716c0758ae/1783678051579436895_sxk8bZOC.webp)
/filters:quality(82)/examples/0c4e006b2739455a867f0731f719c09c/1783677266099782713_Zovi4UHv.webp)
/filters:quality(82)/examples/fa5f84bc40864bcfa097f5f8aea1ead1/1783677269420296541_zrmaWYLz.webp)
/filters:quality(82)/examples/7a79182377b94ab5807ac2b522c79649/1783678063342154753_yytg5aYL.webp)