PopNowAPI
API キーを取得

Topaz Denoise & Sharpen API

Topaz Labs

ノイズ除去・ぼけ補正、解像度そのまま、最大 24MP

topaz/denoise-sharpen/edit
  • 画像ノイズ除去

Topaz Denoise & Sharpen について

ノイズ除去・ぼけ補正、解像度そのまま、最大 24MP。

POST /jobs/createTask でモデル名に topaz/denoise-sharpen/edit を指定すれば呼び出せます。$0.12から。

はじめに

Topaz Denoise & Sharpen は、1 つのエンドポイントで Topaz Labs の 2 つのモデルファミリーを提供します。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 秒後に目と無精ひげが戻りました。3 枚とも入力と同じサイズで返されました。

制限

Denoise と Sharpen は別々のリクエストです。両方が必要な画像は、順番に呼び出してください。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 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

オプションUSD /枚
標準$0.12

実行前に同じリクエスト本文を POST /jobs/quote に送ると、想定料金と上限額を米ドルで確認できます。見積もりではタスクの実行も課金も行いません。

API クイックスタート

Topaz Denoise & Sharpen API を 3 ステップで呼び出す

  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は$0.12/枚です。API は専用の米ドル残高を使用します。サイトのクレジットは API で使えず、API 残高との相互振替もできません。 タスクの受理時に、見積もりの上限額を API 残高から確保します。完了後は実際の使用量で精算し、確保額を超える請求はせず、差額を解放します。タスクが失敗した場合は確保額を解放します。

API でのTopaz Denoise & Sharpenのモデル名は？

POST /jobs/createTask の model フィールドに 画像ノイズ除去は topaz/denoise-sharpen/edit を指定します。

Normal、Strong、Extreme はどれを選べばよいですか？

暗所や圧縮による日常的なノイズには、まず Normal を使ってください。Strong はかなり暗い高感度写真向けで、Extreme より多くのディテールを残します。Extreme はひどく劣化した画像や強く圧縮された画像向けで、細かい質感よりもきれいさを優先します。

写真は大きくなりますか？

なりません。2048×1152 のテストは 2048×1152 のまま、1100×900 のテストは 1100×900 のまま返りました。画素数も増やしたい場合は、そのあとにアップスケーラーを使ってください。

ポートレートにはどのシャープ化プリセットが合いますか？

sharpen_portrait は肌と顔の構造に合わせて調整されています。少し甘い程度の顔なら、sharpen_standard か sharpen_natural のほうが元の印象に近く仕上がります。sharpen_strong は大きくピントを外した写真向けです。

Topaz Denoise & Sharpen API の制限は？

アップロードの上限：30 MB。この範囲を超えるリクエストは、課金される前に拒否されます。

コードを書かずにTopaz Denoise & Sharpenを試せますか？

API キーなしで、API の米ドル残高を使って Playground から Topaz Denoise & Sharpen を実行できます。各実行は対応するコードとともに開発者の履歴に記録されます。

Topaz Denoise & Sharpen についてさらに