Topaz Denoise & Sharpen API

Topaz Labs

노이즈 제거·흐림 보정, 해상도 그대로, 최대 24MP

topaz/denoise-sharpen/edit
  • 이미지 노이즈 제거

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단계로 호출하기

  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의 모델 이름은 무엇인가요?

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 모델을 실행할 수 있습니다. 각 실행은 해당 코드와 함께 개발자 기록에 저장됩니다.

Topaz Denoise & Sharpen 더 알아보기