Skip to main content
CodeFormer빠름높음

CodeFormer

오래된 사진과 AI 생성 얼굴을 위한 강력한 얼굴 복원 모델입니다 (5,400만+ 실행). 복원 품질과 원본 얼굴 충실도의 균형을 조절하는 fidelity 다이얼이 특징이며, Real-ESRGAN 배경 향상을 내장하고 있습니다.

8 크레딧
이미지당
품질↔충실도 균형 다이얼 (codeformer_fidelity)
심하게 손상된 얼굴에도 강건함
Real-ESRGAN 배경 향상 내장
고해상도 출력을 위한 얼굴 업샘플링
최종 확대 배율 조정

지금 바로 실행해보세요

콘솔의 Playground에서 별도 코드 없이 이 모델을 즉시 테스트할 수 있어요

로그인 후 사용해보기

AI 어시스턴트에서 사용하기

이 모델의 사용법을 Claude, ChatGPT 등에 복사

빠른 시작

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "sczhou/codeformer",
  "input": {
    "image": "https://example.com/degraded-photo.jpg",
    "codeformer_fidelity": 0.7,
    "upscale": 2,
    "background_enhance": true,
    "face_upsample": true
  }
}'

파라미터

파라미터타입필수기본값설명
imagestringYes-복원할 얼굴이 있는 입력 이미지
codeformer_fidelitynumberNo0.5품질(낮음)과 원본 얼굴 충실도(높음)의 균형, 0-1
background_enhancebooleanNotrueReal-ESRGAN으로 배경도 함께 향상
face_upsamplebooleanNotrue복원된 얼굴을 고해상도로 업샘플
upscaleintegerNo2이미지의 최종 확대 배율

파일 입력 방법

이 모델의 image 파라미터에 파일을 전달하는 방법은 3가지입니다.

추천

간편 업로드 (Multipart)

POST /v1/predictions/upload에 파일을 직접 첨부합니다. 별도 업로드 과정이 필요 없습니다.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=sczhou/codeformer" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

이미지 URL 전달

공개 접근 가능한 URL을 직접 전달합니다. Storage API로 업로드한 파일의 file_url도 사용 가능합니다.

{
  "model": "sczhou/codeformer",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}
File Upload 문서에서 Presigned URL 방식 등 더 자세한 업로드 방법을 확인하세요.

공통 파라미터

POST /v1/predictions 요청 시 사용되는 공통 파라미터입니다.

파라미터타입필수기본값설명
modelstringYes-모델 식별자
inputobjectYes-위 테이블의 모델별 파라미터를 포함하는 객체
output_folderstringNo-결과물 저장 폴더 경로 (최대 256자, '..' 사용 불가)
webhook_urlstringNo-완료 시 호출할 Webhook URL
is_publicbooleanNofalsetrue 시 결과물을 영구 공개 URL로도 제공

예제

손상 사진 복원

품질과 인물 유사성의 균형을 잡아 심하게 손상된 사진 복원

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "sczhou/codeformer",
  "input": {
    "image": "https://example.com/degraded-photo.jpg",
    "codeformer_fidelity": 0.7,
    "upscale": 2,
    "background_enhance": true,
    "face_upsample": true
  }
}'

팁 & 모범 사례

1인물이 알아볼 수 있어야 하면 codeformer_fidelity를 0.7-0.9로 올리고, 최대 보정은 0.3으로 내리세요
2background_enhance를 켜면 한 번에 사진 전체가 복원됩니다
3심하게 손상된 입력에는 GFPGAN보다 강건하고, 가벼운 손상은 GFPGAN이 더 자연스러울 수 있습니다
4upscale 2면 대부분 충분하며, 더 크게 필요하면 Real-ESRGAN을 이어서 쓰세요

사용 사례

심하게 손상된 사진 복원
AI 얼굴 아티팩트 교정
역사 아카이브 복원
영상 프레임 얼굴 보정
인물 유사성을 유지하는 향상