Topaz Denoise & Sharpen 소개
노이즈 제거·흐림 보정, 해상도 그대로, 최대 24MP.
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은 별도의 요청이므로, 두 가지 보정이 모두 필요한 사진이라면 순서대로 호출하세요. 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 /장 |
|---|---|
| 기본 | US$0.12 |
실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.
API 빠른 시작
Topaz Denoise & Sharpen API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
- 요청 보내기. POST /jobs/createTask에 model은 topaz/denoise-sharpen/edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 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의 모델 이름은 무엇인가요?
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 모델을 코드 없이 사용해 볼 수 있나요?
Playground에서 API 키 없이 API의 미국 달러 잔액으로 Topaz Denoise & Sharpen 모델을 실행할 수 있습니다. 각 실행은 해당 코드와 함께 개발자 기록에 저장됩니다.