소개
엔드포인트 기능
사진 1장의 눈에 보이는 손상(긁힘, 먼지 자국, 필름 입자, 노이즈, 흐릿함)을 복원하고 PNG를 반환합니다. 프롬프트는 없습니다.
주요 입력
유일한 필드는 image_url입니다. JPEG, PNG, WebP 업로드 또는 파일의 직접 링크를 전달합니다.
반환 결과
원본 비율의 약 1메가픽셀 PNG 1장입니다. 흑백과 세피아 사진은 색조가 유지됩니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | 이미지 편집 |
| 보정 대상 | 긁힘, 먼지 자국, 입자, 노이즈, 흐릿함 |
| 색상 | 보낸 색조 유지, 색 입히기 없음 |
| 설정 | 사진 외 설정 없음 |
핵심 기능 및 하이라이트
긁힌 세피아 인물 사진을 한 번에 깔끔하게
테스트 스캔에는 긁힘 4개, 먼지 자국 7개, 입자와 흐릿함이 있었습니다. 결과에서는 모두 사라지고 구도는 그대로 유지되며 남성의 눈, 수염, 재킷 질감이 선명해졌습니다.
얼굴을 바꾸지 않고 복원
같은 영역을 확대하면 머리의 먼지 자국과 피부 입자가 사라지고 표정과 이목구비는 스캔과 일치합니다. 복원에서 얼굴이 가장 중요한 만큼 먼저 확인합니다.
Photo Colorizer와 함께 사용
복원은 원래 색조를 유지합니다. 흑백이나 세피아 사진은 복원한 PNG를 Photo Colorizer로 보냅니다. 긁힌 사진보다 깨끗한 사진에 색을 입혀야 더 고른 결과를 얻습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 복원할 스캔 사진입니다. JPEG, PNG, WebP 업로드 또는 파일의 직접 링크를 전달합니다. 1자 이상 |
요금
$0.048 / 장
크기와 관계없이 복원 사진당 고정 요금입니다. 처리에 실패하면 비용이 청구되지 않습니다.
활용 사례
가족 앨범과 보관하던 인화 사진
조부모의 인물 사진, 결혼식 사진, 휴가 스냅의 스캔을 정리해 슬라이드쇼, 인쇄 앨범, 가족 단체 채팅에 활용합니다.
자료 보관과 지역사 프로젝트
사진마다 긁힘이나 먼지가 있는 스캔 자료를 복원해 자원봉사자가 보정 대신 설명 작성에 시간을 쓸 수 있게 합니다.
추모·기념일 제작물
소중한 사진 한 장을 액자, 추모 예식 순서지, 헌정 영상에 쓸 수 있도록 준비합니다. 별도 보정 의뢰가 필요 없습니다.
프롬프트 가이드 및 실전 팁
인화 사진을 스캔하거나 촬영합니다
사진을 평평하게 펴고 빛 반사를 피하며 전체가 화면에 들어오게 합니다. 보이는 손상을 복원하므로 얼굴 위의 반사는 긁힘보다 복구하기 어렵습니다.
image_url을 전송합니다
스캔을 JPEG, PNG, WebP로 업로드하거나 파일의 직접 링크를 전달합니다. 요청은 이것으로 끝입니다.
얼굴을 확인한 후 색을 입힙니다
눈과 입을 원본과 실제 크기로 비교합니다. 흑백 사진이라면 복원된 PNG를 Photo Colorizer (/models/photo-colorizer-v1)로 보냅니다.
소개
Old Photo Restorer는 스캔한 인화 사진을 위한 단일 필드 엔드포인트입니다. image_url로 사진을 보내면 긁힘, 먼지 자국, 입자와 흐릿함을 제거해 반환합니다. 색을 입히지 않으며 프롬프트도 필요 없습니다.
요청
{
"image_url": "https://example.com/scan.jpg"
}
테스트 결과
옥상 인물 사진의 640×960 세피아 스캔에 일반적인 손상인 긴 긁힘 4개, 먼지 7개, 입자, 흐릿함과 강한 JPEG 압축을 더했습니다. 약 17초 후 모든 긁힘과 먼지가 사라지고 얼굴, 수염, 재킷이 눈에 띄게 선명해진 832×1248 PNG가 반환되었습니다. 분명히 같은 인물이었습니다. 하늘의 옅은 구름은 고른 밝은 하늘로 매끈해졌고 세피아 색조는 밝아졌습니다.
깨끗한 2048×1152 컬러 사진은 색이 유지되고 피부가 조금 매끈해진 1360×768로 반환되었습니다. 어떤 사진을 보내든 출력이 약 1메가픽셀이라는 크기 규칙을 보여줍니다.
작업 흐름
사진 복원은 비동기 방식으로 진행됩니다. 작업을 생성하고 완료될 때까지 폴링한 뒤 SpicyAPI 저장소에서 PNG를 다운로드합니다. 요청당 사진 1장에 고정 요금이 적용되며 실패한 요청은 무료입니다.
팁
- 충분한 해상도로 스캔하고 전송 전 앨범 페이지나 액자 부분을 잘라냅니다.
- 눈부심과 반사는 긁힘보다 제거하기 어려우므로 플래시 없이 촬영합니다.
- 색이 필요하면 복원 PNG를 Photo Colorizer (
/models/photo-colorizer-v1)로 보냅니다. - 인쇄용으로 더 큰 파일이 필요하면 복원 후 Image Upscaler (
/models/image-upscaler-v1)를 사용합니다.
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": "spicyapi/photo-restorer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png"
}
}'
# 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 레퍼런스에서 확인하세요.




