사진 컬러화 API란?
ImgGen AI 컬러화 API는 흑백 또는 그레이스케일 이미지에 사실적인 색을 입히는 REST 엔드포인트입니다. 모델이 이미지 내용 자체에서 피부, 옷, 초목, 하늘, 재질의 그럴듯한 색을 추론하므로 참조 팔레트나 수동 선택이 필요 없습니다. 색이 입혀진 결과는 같은 응답으로 반환됩니다.
이것은 ImgGen AI 이미지 편집 API의 일곱 개 엔드포인트 중 하나이며, 모두 같은 API 키와 같은 기본 URL, 동일한 요청·응답 형식을 공유합니다. 코드가 아니라 브라우저에서도 이 기능이 필요하다면, 같은 AI 모델이 Colorize Photo 도구를 구동합니다.
요청 파라미터
https://app.imggen.ai/v1/colorize-photo 으로 POST 요청을 보내고, Authorization 헤더의 API 키로 인증하세요.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| image | file | 필수 | — | 컬러화하면서 긁힘과 찢김을 복원합니다. |
| removeTears | boolean | 선택 | false | Repair scratches and tears while colorizing. |
사진 컬러화 API는 어떻게 연동하나요?
ImgGen 계정에서 API 키를 만들고 환경 변수로 지정한 뒤 엔드포인트를 호출하세요. 같은 요청을 cURL, Node.js, Python으로 보여드립니다.
curl --request POST \
--url 'https://app.imggen.ai/v1/colorize-photo' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpg \
--form removeTears=falseimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('removeTears', 'false');
const res = await fetch('https://app.imggen.ai/v1/colorize-photo', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/colorize-photo",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
data={"removeTears": "false"},
)
data = res.json()
with open("result.png", "wb") as out:
out.write(base64.b64decode(data["image"]))응답
성공한 호출은 JSON을 반환합니다. 결과는 base64로 인코딩되어 있으니 디스크나 오브젝트 스토리지에 쓰기 전에 디코딩하세요. 성공한 응답에는 호출 후 잔액을 담은 X-Credit-Remaining 헤더도 함께 옵니다.
{
"success": true,
"message": "Image colorized successfully",
"image": "iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="
}알아두면 좋은 제한과 동작
이 엔드포인트는 파일 최대 25MB의 JPEG(JPG), PNG, WebP를 받고 60초 이내에 동기적으로 응답합니다. 폴링할 작업도, 설정할 웹훅도 없습니다.
색은 추론된 것이지 복원된 것이 아닙니다
모델은 이미지 내용으로부터 그럴듯한 색을 예측합니다. 설득력 있는 해석을 만들어 낼 뿐, 역사적으로 검증된 것은 아닙니다. 결과를 사용자에게 보여준다면 이 점을 분명히 밝히는 편이 좋습니다.
컬러화하면서 복원까지
removeTears=true로 설정하면 복원 엔드포인트를 두 번째로 호출하지 않고도 같은 과정에서 긁힘과 물리적 손상을 바로잡습니다.
이미 색이 있는 이미지
이 엔드포인트는 그레이스케일 입력을 위해 만들어졌습니다. 이미 색이 있는 이미지를 보내는 것은 의미가 없습니다. 목적이 복원이라면 복원 엔드포인트를 사용하세요.
사진 컬러화 API는 어디에 쓰이나요?
여러 팀이 이 엔드포인트를 실제 서비스에 넣어 프로그래밍 방식으로 대규모 이미지를 처리하는 사례입니다.
가족사 관련 제품
물려받은 사진을 앱 안에서 컬러화하도록, 유료 업그레이드나 참여 유도 기능으로 사용자에게 제공하세요.
편집·출판
기획 기사와 회고를 위해 아카이브 사진의 컬러 버전을 만들되, 해석임을 분명히 밝혀 사용하세요.
아카이브 대량 처리
그레이스케일 소장품 전체에 대해 컬러 열람본을 만들면서 원본은 그대로 보존하세요.
추모·선물 서비스
주문 처리의 일부로 고객이 올린 사진을 자동으로 컬러화하고 복원하세요.
사진 컬러화 API의 비용은 얼마인가요?
성공한 호출 한 번에 2크레딧가 들며, 따라서 이미지당 실질 비용은 이용 중인 플랜에 따라 정해집니다. 크레딧은 플랜에서 차감되고 모든 엔드포인트와 웹 편집기가 함께 쓰므로, 도구별로 별도 할당량을 살 필요가 없습니다. 실패한 호출은 자동으로 환불됩니다. 자세한 내용은 요금 페이지를 확인하세요.
| 플랜 | 가격 | 크레딧 | API |
|---|---|---|---|
| Free | $0 | 1회성 무료 크레딧 50 | API 접근 없음 |
| Starter | $9.99 / month | 월 400 크레딧 | API 접근 포함 |
| Pro | $29.99 / month | 월 1,400 크레딧 | API 접근 + 우선 지원 |
| Enterprise | Custom | 맞춤 사용량 | 전용 인프라 |
크레딧 비용과 제한 최종 확인일 2026-08-27.
관련 엔드포인트 및 도구
사진 컬러화 API를 쓰는 팀이 다음으로 자주 찾는 것들입니다.
사진 컬러화 API 자주 묻는 질문
- 흑백 이미지를 받아 색이 입혀진 버전을 반환하는 HTTP 엔드포인트입니다. 모델이 사진의 내용(얼굴, 옷, 초목, 하늘, 재질)을 읽고 어울리는 색을 예측하므로, 팔레트를 지정하지 않아도 자연스러운 결과를 얻습니다.
- 검증된 것이라기보다 그럴듯한 것입니다. 모델은 1953년의 그 재킷이 실제로 무슨 색이었는지 알지 못합니다. 화면에 보이는 모든 것을 근거로 가장 가능성 높은 채색을 내놓을 뿐입니다. 피부 톤, 초목, 하늘은 변동 폭이 좁아 대체로 설득력이 있고, 옷이나 도장면처럼 색이 임의로 정해지는 물체는 근거 있는 추측입니다. 역사 자료라면 결과를 해석으로 제시하세요.
- 성공한 호출당 2크레딧입니다. Starter는 월 400크레딧에 9.99달러, Pro는 1,400크레딧에 29.99달러이며, 구독 중에는 미사용 크레딧이 이월됩니다.
- ImgGen 계정에서 API 키를 만든 뒤, image 필드가 담긴 멀티파트 폼을 Authorization: Bearer 헤더로 인증하며 https://app.imggen.ai/v1/colorize-photo 로 POST 하세요. JSON 응답의 base64 image 필드를 디코딩해 자산을 보관하는 곳에 저장하면 됩니다. cURL·Node.js·Python 예제가 이 페이지에 있습니다.
- 이 엔드포인트는 색을 입히기 위해 만들어졌고 선택적으로 찢김을 복원할 수 있습니다. 복원 엔드포인트는 손상을 고치기 위해 만들어졌고 선택적으로 색을 입힐 수 있습니다. 사진이 주로 손상되었다면 복원을, 그저 흑백일 뿐이라면 이쪽을 쓰세요.
- 이 API는 이미지 한 장당 최대 25MB의 JPEG(JPG), PNG, WebP 파일을 받습니다. 결과는 JSON 응답 안에 base64로 인코딩된 이미지로 반환됩니다.
- 아니요. 이 API는 상태를 저장하지 않습니다. 프로젝트를 만들지도, 파일을 저장하지도, 여러분의 이미지를 보관하지도 않습니다. 업로드된 파일은 임시 객체에 기록되어 처리된 뒤, 응답이 반환되는 즉시 삭제됩니다. 남는 것은 호출이 있었다는 사실과 소모된 크레딧 수를 기록한 사용 로그뿐입니다. 여러분의 이미지는 결코 모델 학습에 사용되지 않습니다.
시작하기
사진 컬러화 API 호출을 시작하세요
키 하나로 일곱 개 엔드포인트가 모두 열립니다. 워터마크 없음, 완전한 상업적 권리, 그리고 보내신 어떤 것도 응답이 반환된 뒤에는 저장되지 않습니다.
API 키 받기