Topaz Denoise & Sharpen API

關於 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"
}

預設

我們的測試

一張 2048×1152、燭光下的人像，人工加入大量彩色雜訊，在 denoise_normal 上約 19 秒後恢復乾淨；眼睛、耳環和背景的散景光點都保住了，雀斑則變淡。一張 1024×1536、帶細顆粒的咖啡廳人像（以 WebP 傳送），在 denoise_strong 上約 25 秒去掉顆粒，捲髮與針織紋路保持不變。一張刻意模糊的 1100×900 人像，在 sharpen_standard 上 14 秒內找回眼睛和鬍渣。三張圖都以輸入尺寸返回。

限制

Denoise 與 Sharpen 是獨立的請求，若一張圖兩者都需要，請串接呼叫。銳化會重建細節，因此請以原始尺寸檢查人臉和文字。

請求參數

價格

價格以美元計。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。 任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

執行前，將相同請求內容傳送至 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 相關內容

試用

Topaz Denoise & Sharpen AI 生成圖片 線上使用在 PopNow 用 Topaz Denoise & Sharpen 生成圖片

文件

API 文件中的 Topaz Denoise & Sharpen 模型名稱與輸入格式PopNow API 快速入門：送出第一個請求PopNow API 圖片生成指南Webhook：不用輪詢也能取得 Topaz Denoise & Sharpen 的結果