얼굴 화질 개선Face Enhancer 소개
Face Enhancer는 사진 속 얼굴 최대 세 명을 큰 얼굴부터 복원하고 선명하게 해요. 이미지의 다른 부분은 바뀌지 않고, 해상도도 그대로예요. 결과는 JPEG, PNG, WebP로 받을 수 있어요. 작성할 프롬프트는 없어요.
POST /jobs/createTask에서 모델 이름을 popnow/face-enhancer-v1/edit(으)로 지정하면 호출할 수 있습니다. US$0.012부터.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 출발점이 되는 이미지. |
output_format | 아니요 | 결과 파일 형식. jpeg · png · webp · 기본값: jpeg |
가격
요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
| 옵션 | USD /장 |
|---|---|
| 기본 | US$0.012 |
실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.
API 빠른 시작
Face Enhancer API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/face-enhancer-v1/edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/face-enhancer-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Face Enhancer API 질문
Face Enhancer API 요금은 얼마인가요?
Face Enhancer 가격은 US$0.012 /장입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
API에서 Face Enhancer의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 얼굴 화질 개선: popnow/face-enhancer-v1/edit을(를) 넣으세요.
사진 크기가 커지나요?
아닙니다. 결과는 보낸 해상도로 돌아옵니다. 테스트한 720×404 사진도 720×404로 돌아왔습니다. 픽셀 수를 늘리려면 /models/image-upscaler-v1의 Image Upscaler를 사용하십시오.
얼굴은 몇 개까지 복원하나요?
최대 3개이며 큰 얼굴부터 복원합니다. 그 밖의 얼굴과 얼굴 밖의 나머지 부분은 그대로 남습니다.
사람이 여전히 같은 사람으로 보이나요?
테스트에서는 얼굴이 같은 사람으로 알아볼 수 있는 상태를 유지했습니다. 세부를 다시 그리는 방식이므로 공개하기 전에 원본과 비교해 확인하십시오.
무엇을 그대로 두고, 무엇을 부드럽게 만드나요?
배경은 건드리지 않습니다. 테스트에서 피사체 뒤편 술병 진열대는 원래의 압축 블록을 그대로 유지했습니다. 얼굴의 피부는 실제 사진보다 조금 매끄럽게 나왔습니다.
코드 없이 Face Enhancer을(를) 써 볼 수 있나요?
API 키 없이 Playground에서 API 달러 잔액으로 Face Enhancer을(를) 실행할 수 있습니다. 실행마다 해당 코드와 함께 개발자 기록에 저장됩니다.
모든 Face Enhancer 모델
Image Upscaler는 사진 전체를 키우고, Face Enhancer는 같은 크기에서 얼굴을 고쳐요.