はじめに
このエンドポイントでできること
写真 1 枚に Topaz Labs のモデルを 1 つ実行します。Denoise 系のプリセットは粒子、高感度ノイズ、圧縮による斑点を取り除き、Sharpen 系のプリセットは甘いピント、手ブレ、レンズのボケを補正します。出力の幅と高さは入力と同じです。
主な入力
image_url には 24 メガピクセル以下の JPEG、PNG、WebP を、アップロードまたは公開リンクで指定します。preset でモデルを選び、既定値は denoise_normal です。output_format は jpeg（既定）か png です。
返ってくるもの
非同期タスクの完了後、リクエストごとに 1 枚の画像がプラットフォームのストレージから配信されます。24 メガピクセルを超える画像は、送信時に invalid_request で拒否されます。
| 項目 | 値 |
|---|---|
| 入力 | 画像 |
| 出力 | 画像 |
| エンドポイント | 画像編集 |
| プリセット | ノイズ除去 3 段階、シャープ化 8 種類 |
| プロンプト | なし |
| 課金 | 1 枚あたり定額 |
主な機能とハイライト
キャンドルの灯るバーの写真から斑点だけを消し、顔はそのまま
2048×1152 のポートレートに強いカラーノイズを加え、Denoise Normal に通しました。セーターと暗いワイン棚の斑点は消え、目、フープピアス、背景の玉ボケは元の位置に残りました。そばかすはノイズのない元画像より薄くなっています。
カフェのポートレートからフィルム調の粒子を除去
肌、髪、ニットに細かいモノクロの粒子が乗った 1024×1536 の WebP を Denoise Strong に通すと、約 25 秒で粒子が消えました。巻き髪の毛束とセーターの編み目は残り、肌は少しなめらかになりました。
Sharpen Standard でぼやけた顔にピントを戻す
わざとぼかしたポートレートが、14 秒で目、眉、無精ひげを読み取れる状態に戻りました。こうしたディテールはモデルが再構成したものなので、使う前に等倍で確認してください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
image_url | はい | 補正する写真です。JPEG、PNG、WebP をアップロードまたは公開リンクで指定し、上限は 24 メガピクセル（6000×4000 は収まります）です。 1 文字以上 |
preset | いいえ | 実行する Topaz のモデルです。 |
output_format | いいえ | jpeg（既定）または png です。png は非可逆圧縮をもう一度かけずに済みますが、ファイルは大きくなります。 |
料金
$0.12 / 枚
11 種類のプリセットと 2 種類の出力形式のどれを選んでも、完成した 1 枚ごとに同じ定額がかかります。処理に失敗した画像や受付で拒否された画像には料金がかかりません。
ユースケース
夜や屋内で撮ったスマホ写真
コンサート、レストラン、暗いリビングで撮った高感度の写真はまだらになりがちです。まず Denoise Normal を使い、影に斑点が残るなら Strong に上げてください。
AI 生成画像の粒状感
画像モデルによっては、肌や平坦な背景に細かい粒子や繰り返し模様が残ります。Denoise を 1 回かけておくと、拡大、トリミング、印刷の前に整った素材になります。
ほぼピントが合っている写真
わずかなピントのずれ、少しの手ブレ、甘いレンズに対応します。軽いものは Sharpen Standard、その 2 つの問題には Motion Blur と Lens Blur、肌と毛並みには Portrait と Wildlife が向いています。
プロンプトガイドと実践のヒント
サイズを確認する
24 メガピクセル以下の JPEG、PNG、WebP を、アップロードまたは公開リンクで送ってください。これより大きいファイルは送信時に拒否されるため、先に縮小してください。
プリセットを 1 つ選ぶ
粒子や斑点が気になるときは denoise_ 系、ボケが気になるときは sharpen_ 系を選びます。1 回のリクエストで実行できるプリセットは 1 つです。両方必要なら、先にノイズを除去し、その結果を Sharpen に送ってください。
結果を取得して比べる
タスクを作成し、完了するまでポーリングして、プラットフォームのストレージからファイルをダウンロードします。目、髪、細かい質感を中心に、元画像と 100% 表示で比べてください。
概要
Topaz Denoise & Sharpen は、Topaz Labs の 2 つのモデルファミリーを 1 つのエンドポイントで提供します。Denoise は本来のディテールを残しながらノイズと粒子を取り除き、Sharpen はピントのずれ、動き、甘いレンズで失われた鮮明さを取り戻します。モデルは preset で選び、プロンプトはありません。
リクエスト
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}
プリセット
| preset | 用途 |
|---|---|
denoise_normal | 暗所や圧縮による日常的なノイズ（既定） |
denoise_strong | かなり暗い写真や高感度写真。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 枚とも入力と同じサイズで返りました。
制限
入力は 24 メガピクセルまで（6000×4000 は収まります）で、これを超える画像は課金前に拒否されます。Denoise と Sharpen は別々のリクエストなので、両方必要な画像は順につなげてください。シャープ化はディテールを再構成するため、顔や文字は等倍で確認してください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "topaz/denoise-sharpen/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "denoise_normal"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
