소개
이 엔드포인트가 하는 일
사진 한 장에 Topaz Labs 모델 하나를 실행합니다. Denoise 프리셋은 입자, 고감도 노이즈, 압축 반점을 없애고, Sharpen 프리셋은 무른 초점, 손떨림, 렌즈 흐림을 바로잡습니다. 출력의 너비와 높이는 입력과 같습니다.
중요한 입력
image_url에는 24메가픽셀 이하의 JPEG, PNG, WebP를 업로드하거나 공개 링크로 넣습니다. preset이 모델을 고르며 기본값은 denoise_normal입니다. output_format은 jpeg(기본값) 또는 png입니다.
돌려받는 것
비동기 작업이 끝나면 요청마다 이미지 한 장이 플랫폼 저장소에서 제공됩니다. 24메가픽셀을 넘는 이미지는 제출할 때 invalid_request로 거부됩니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | 이미지 편집 |
| 프리셋 | 노이즈 제거 3단계, 선명화 모델 8종 |
| 프롬프트 | 없음 |
| 과금 | 이미지당 고정 가격 |
핵심 기능 및 하이라이트
촛불 켜진 바 사진에서 반점만 지우고 얼굴은 그대로
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종 중 무엇을 고르든 완성된 이미지 한 장마다 같은 고정 금액이 청구됩니다. 처리에 실패했거나 접수 단계에서 거부된 이미지에는 요금이 붙지 않습니다.
활용 사례
밤이나 실내에서 찍은 휴대폰 사진
공연장, 식당, 어두운 거실에서 찍은 고감도 사진은 얼룩덜룩해집니다. 먼저 Denoise Normal을 쓰고, 그림자에 반점이 남으면 Strong으로 올리십시오.
AI 생성 이미지의 입자
일부 이미지 모델은 피부와 평평한 배경에 고운 입자나 반복 무늬를 남깁니다. Denoise를 한 번 거치면 확대, 자르기, 인쇄 전에 더 깨끗한 바탕을 얻을 수 있습니다.
거의 초점이 맞은 사진
살짝 빗나간 초점, 약간의 손떨림, 무른 렌즈에 대응합니다. 가벼운 경우는 Sharpen Standard, 그 두 문제에는 Motion Blur와 Lens Blur, 피부와 털에는 Portrait와 Wildlife가 맞습니다.
프롬프트 가이드 및 실전 팁
크기 확인
24메가픽셀 이하의 JPEG, PNG, WebP를 업로드하거나 공개 링크로 보내십시오. 이보다 큰 파일은 제출할 때 거부되므로 먼저 줄이십시오.
프리셋 하나 선택
입자나 반점이 문제라면 denoise_ 프리셋을, 흐림이 문제라면 sharpen_ 프리셋을 고르십시오. 요청 한 번에 프리셋 하나만 실행합니다. 둘 다 필요하면 먼저 노이즈를 없앤 뒤 그 결과를 Sharpen으로 보내십시오.
조회하고 비교
작업을 만들고 끝날 때까지 상태를 조회한 다음 플랫폼 저장소에서 파일을 내려받으십시오. 눈, 머리카락, 고운 질감을 중심으로 원본과 100% 배율에서 비교하십시오.
소개
Topaz Denoise & Sharpen은 Topaz Labs의 두 모델 계열을 엔드포인트 하나로 제공합니다. 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초 만에 눈과 수염을 되찾았습니다. 세 장 모두 입력 크기 그대로 돌아왔습니다.
제한
입력은 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 레퍼런스에서 확인하세요.
