PopNowAPI
获取 API 密钥

Topaz Denoise & Sharpen API

Topaz Labs 出品

去噪或去模糊,分辨率不变,最高 2400 万像素

topaz/denoise-sharpen/edit
  • 图片降噪

关于 Topaz Denoise & Sharpen

去噪或去模糊,分辨率不变,最高 2400 万像素。

在 POST /jobs/createTask 里把模型名写成 topaz/denoise-sharpen/edit 即可调用,US$0.12 起。

简介

Topaz Denoise & Sharpen 通过同一个接口提供两个 Topaz Labs 模型系列。Denoise 去除噪点与颗粒,同时尽量保留真实细节;Sharpen 找回因对焦失误、运动或镜头柔化而丢失的清晰度。通过 preset 选择模型,无需提示词。

请求示例

{
  "image_url": "https://example.com/night-shot.jpg",
  "preset": "denoise_normal",
  "output_format": "jpeg"
}

预设

预设适用场景
denoise_normal日常的低光或压缩噪点(默认)
denoise_strong极暗或高 ISO 照片;比 Extreme 保留更多细节
denoise_extreme严重劣化或高度压缩的图片
sharpen_standard轻微发软或轻微抖动;通常的起点
sharpen_strong严重对焦失误
sharpen_natural轻柔锐化,保留有机纹理
sharpen_portrait人脸与皮肤
sharpen_wildlife毛发、羽毛及其他自然细节
sharpen_refocus略微失焦照片中的精细细节
sharpen_motion_blur相机或主体移动造成的模糊
sharpen_lens_blur离焦与镜头柔化

我们的测试

一张 2048×1152、烛光下的人像,人为加入大量彩色噪点,在 denoise_normal 上约 19 秒后恢复干净;眼睛、耳环和背景虚化光斑都保持住了,雀斑则淡化了。一张 1024×1536、带细颗粒的咖啡馆人像(以 WebP 发送),在 denoise_strong 上约 25 秒去掉了颗粒,卷发与针织纹理保持不变。一张刻意模糊的 1100×900 人像,在 sharpen_standard 上 14 秒内找回了眼睛和胡茬。三张图都以输入尺寸返回。

限制

Denoise 与 Sharpen 是两个独立请求,如果图片两方面都需要处理,请串联调用。锐化会重建细节,因此请以原始尺寸检查人脸和文字。

请求参数

参数必填说明
image_url是作为起点的那张图。
output_format否结果的文件格式。 jpeg · png · 默认值: jpeg
preset否从当前模型提供的选项中选择预设。 denoise_normal · denoise_strong · denoise_extreme · sharpen_standard · sharpen_strong · sharpen_natural · sharpen_portrait · sharpen_wildlife · sharpen_refocus · sharpen_motion_blur · sharpen_lens_blur · 默认值: denoise_normal

价格

价格以美元计。API 使用独立的美元余额。网站积分不能用于 API,也不能转入 API 余额;API 余额同样不能转为网站积分。 任务受理时,从 API 余额中冻结报价的最高金额;完成后按实际用量结算,实扣不超过冻结额,并释放剩余金额。任务失败则释放冻结额。

选项USD /张
标准US$0.12

运行前,将相同请求体发送到 POST /jobs/quote,可查看预计费用和最高费用,单位为美元。报价不会运行任务或扣款。

API 快速上手

三步调用 Topaz Denoise & Sharpen API

  1. 创建 API 密钥. 登录 PopNow,在 API 控制台创建密钥。密钥以 sk-popnow- 开头,API 调用使用独立的美元余额。
  2. 发送请求. 向 POST /jobs/createTask 发请求,model 填 topaz/denoise-sharpen/edit,input 按参数表填写。响应会立刻返回任务 ID。
  3. 取回结果. 用任务 ID 轮询 GET /jobs/recordInfo,或者传 callBackUrl,结果会推送到这个地址。任务成功后下载输出链接。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "topaz/denoise-sharpen/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "preset": "denoise_normal",
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

请替换为自己的提示词与素材链接。响应格式、轮询与回调说明请参阅 API 页签。

Topaz Denoise & Sharpen API 常见问题

Topaz Denoise & Sharpen API 怎么收费?

Topaz Denoise & Sharpen:US$0.12/张。API 使用独立的美元余额。网站积分不能用于 API,也不能转入 API 余额;API 余额同样不能转为网站积分。 任务受理时,从 API 余额中冻结报价的最高金额;完成后按实际用量结算,实扣不超过冻结额,并释放剩余金额。任务失败则释放冻结额。

Topaz Denoise & Sharpen 在 API 里的调用名是什么?

在 POST /jobs/createTask 的 model 字段里填 图片降噪用 topaz/denoise-sharpen/edit。

Topaz Denoise & Sharpen API 有哪些限制?

单个文件大小上限:30 MB。超出这些限制的请求会在扣费之前被拒绝。

不写代码能试 Topaz Denoise & Sharpen 吗?

无需 API 密钥,即可在 Playground 用 API 美元余额运行 Topaz Denoise & Sharpen。每次运行记入开发者历史,并附对应代码。

关于 Topaz Denoise & Sharpen 的更多内容