소개
엔드포인트 기능
흑백, 세피아, 빛바랜 사진 1장에 색을 입혀 JPEG를 반환합니다. 색은 사진에서 추정하며 프롬프트나 색상표는 없습니다.
주요 입력
입력 필드는 image_url 하나뿐입니다. JPEG, PNG, WebP 사진을 업로드하거나 직접 링크를 전달합니다.
반환 결과
가로·세로가 입력의 약 2~3배인 JPEG 1장입니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | 이미지 편집 |
| 설정 | 사진 외 설정 없음 |
| 권장 입력 | 깨끗한 스캔, 손상 사진은 먼저 복원 |
핵심 기능 및 하이라이트
흑백 옥상 인물 사진을 노을 장면으로
평범한 흑백 사진에 따뜻한 피부색, 갈색 재킷, 파랑에서 주황으로 이어지는 노을과 도시의 밝은 창문을 더했습니다. 원본 파일에 없던 색을 형태와 명암에서 추정했습니다.
긁힌 세피아 사진을 깨끗한 컬러 사진으로
왼쪽은 손상된 스캔, 가운데는 Old Photo Restorer로 복원한 스캔, 오른쪽은 복원본을 Photo Colorizer로 색 입힌 결과입니다. 정리된 사진에 색을 입히자 피부와 하늘이 고르게 유지되었습니다.
사진을 보고 색을 추정합니다
흑백 사진에는 색 정보가 없으므로 모든 색은 모델이 장면을 해석한 결과입니다. 자연스럽게 보이는 해석으로 받아들이고 원본도 함께 보관합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 색을 입힐 흑백·세피아·빛바랜 사진입니다. JPEG·PNG·WebP 파일을 업로드하거나 직접 링크로 보낼 수 있습니다. 1자 이상 |
요금
$0.06 / 장
색 입힌 사진당 고정 요금이며 커진 출력에 추가 비용은 없습니다. 실패한 작업은 무료입니다.
활용 사례
가족의 역사를 생생하게
부모님이나 조부모님 인물 사진의 컬러 버전을 가족과 나누고 앨범이나 추모 페이지에서 원본 옆에 배치합니다.
역사·다큐멘터리 콘텐츠
보관 사진에 색을 입혀 영상 에세이, 박물관 설명, 소셜 게시물에 쓰고 비교할 수 있도록 원본도 함께 보관합니다.
사진 복원 작업 흐름
Old Photo Restorer 다음에 연결합니다. 먼저 복원하고 색을 입힌 뒤 인쇄가 필요하면 확대합니다.
프롬프트 가이드 및 실전 팁
깨끗한 스캔으로 시작합니다
긁힘이나 먼지가 없는 사진에서 가장 잘 작동합니다. 사진이 손상되었다면 먼저 Old Photo Restorer (/models/photo-restorer-v1)를 실행하고 결과에 색을 입힙니다.
image_url을 전송합니다
흑백·세피아 사진을 JPEG, PNG, WebP로 업로드하거나 파일의 직접 링크를 전달합니다.
추정된 색을 확인합니다
머리카락, 눈, 옷의 색은 복구가 아니라 추정입니다. 실제 색을 안다면 결과를 수동 보정의 출발점으로 사용합니다.
소개
Photo Colorizer는 흑백, 세피아, 빛바랜 사진에 자연스러운 색을 입힙니다. 입력은 image_url뿐이며 피부, 머리카락, 옷, 하늘, 건물의 색을 사진의 형태와 명암에서 추정합니다.
요청
{
"image_url": "https://example.com/grandparents-1958.jpg"
}
테스트 결과
옥상 남성의 768×1152 흑백 인물 사진이 약 17초 후 1664×2496 JPEG로 반환되었습니다. 따뜻한 피부색, 갈색 재킷, 흰 티셔츠, 푸른 도시 스카이라인 뒤 주황빛 노을이 생겼습니다. 바에 있는 두 사람의 1024×576 사진은 녹색·빨간색 와인 병과 크림색 스웨터가 있는 2848×1600으로 나왔습니다. 여성의 머리카락은 갈색이었지만 흑백 변환 전 컬러 사진에서는 붉은색이었습니다. 이런 추정은 확인해야 합니다.
긁힌 세피아 스캔을 Old Photo Restorer로 복원한 뒤 색을 입히기도 했습니다. 복원 후 색 입힌 인물 사진은 피부가 고르고 하늘이 깨끗했습니다.
작업 흐름
호출은 비동기식입니다. 작업을 생성하고 완료될 때까지 폴링한 뒤 SpicyAPI 저장소에서 JPEG를 다운로드합니다. 사진 한 장마다 같은 요금이 붙고, 실패한 처리는 청구되지 않습니다.
팁
- 손상은 색 추정을 방해하므로 먼저 Old Photo Restorer (
/models/photo-restorer-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-colorizer-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 레퍼런스에서 확인하세요.




