소개
이 엔드포인트가 하는 일
사진 1장을 받아 최대 3개의 얼굴을 큰 얼굴부터 복원하고 선명하게 다듬은 사본을 돌려줍니다. 얼굴 밖의 영역은 그대로 남고 해상도도 바뀌지 않습니다. 프롬프트는 없습니다.
중요한 입력
image_url은 사진입니다. JPEG, PNG 또는 WebP 업로드나 공개 URL을 쓸 수 있습니다. output_format은 파일 형식을 정합니다. jpeg(기본값), png, webp 중에서 고릅니다. 실제 사람 얼굴이 적당히 크고 또렷하게 보이는 사진일수록 개선 폭이 큽니다.
돌려받는 것
요청 1건당 보낸 것과 같은 해상도의 이미지 1장이 작업이 끝난 뒤 플랫폼 스토리지에서 제공됩니다. 더 많은 픽셀이 필요하면 /models/image-upscaler-v1을 사용하십시오.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 엔드포인트 | 이미지 편집 |
| 얼굴 수 | 최대 3개, 큰 얼굴부터 |
| 나머지 영역 | 그대로 유지 |
| 조절 항목 | 프롬프트 없음. 파일 형식만 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 복원할 사진입니다. JPEG, PNG 또는 WebP 업로드나 파일의 공개 링크를 넣으십시오. 1자 이상 |
output_format | 아니요 | jpeg(기본값), png 또는 webp입니다. png는 손실 압축을 한 번 더 거치지 않지만 파일이 더 큽니다. |
요금
$0.012 / 장
이미지 1장당 정액으로 과금합니다. 출력 파일 형식은 요금에 영향을 주지 않으며, 실패한 요청은 과금되지 않습니다.
활용 사례
크기가 줄고 여러 번 압축된 사진
채팅 앱이나 소셜 피드를 거쳤거나 여러 번 저장한 사진은 얼굴에서 세부가 먼저 사라집니다. 한 번 처리해 눈, 눈썹, 수염과 피부 질감을 되살리십시오.
프로필과 팀 사진
조금 흐린 초상 사진을 프로필, 팀 페이지나 발표자 소개에 쓰기 전에 정리하십시오. 구도, 조명과 배경은 촬영한 그대로 남습니다.
더 큰 레이아웃을 쓰기 전에
먼저 얼굴을 정리한 뒤, 배너나 인쇄물에 더 많은 픽셀이 필요하면 /models/image-upscaler-v1의 Image Upscaler를 사용하십시오.
프롬프트 가이드 및 실전 팁
얼굴 상태 확인
실제 사람 얼굴이 적당히 크고 또렷하게 보일수록 가장 많이 개선됩니다. 많이 가려진 얼굴, 아주 작은 얼굴, 심하게 흐린 얼굴과 일러스트나 애니메이션 얼굴은 개선 폭이 작습니다.
image_url보내기image_url은 JPEG, PNG 또는 WebP 업로드나 공개 URL로 된 사진입니다. jpeg 대신 png나 webp를 원하면 output_format을 추가하십시오.
폴링 후 비교
호출은 비동기입니다. 작업을 만들고, 끝날 때까지 폴링한 뒤, 플랫폼 스토리지에서 이미지를 받으십시오. 눈과 피부 주변을 원본과 원래 크기에서 비교하십시오.
소개
Face Enhancer는 사진 1장 속 얼굴을 복원하고 선명하게 다듬습니다. 최대 3개의 얼굴을 큰 얼굴부터 찾아, 압축, 축소 또는 흐림으로 사라진 세부, 즉 눈, 눈썹, 수염과 피부 질감을 되살립니다. 얼굴 밖의 영역은 그대로 남고, 결과 그림은 보낸 것과 같은 해상도로 돌아옵니다. 프롬프트는 없으며 파일 형식 외에 조절할 항목도 없습니다.
요청
{
"image_url": "https://example.com/portrait.jpg",
"output_format": "jpeg"
}
image_url은 필수 항목 하나입니다. output_format의 기본값은 jpeg이며, 원하면 png나 webp로 바꾸십시오.
바뀌는 것과 그대로 남는 것
바뀌는 것은 얼굴이고 사진의 나머지는 바뀌지 않습니다. 테스트에서는 술집에 있는 남성을 찍은 720×404 JPEG 초상을 일부러 크기를 절반으로 줄였다가 다시 키우고 심하게 압축했습니다. 약 9초의 처리 시간 후 720×404로 돌아왔습니다. 눈, 눈썹, 수염과 피부 질감이 뚜렷하게 선명해졌고, 여전히 같은 사람으로 알아볼 수 있었습니다. 피부는 실제 사진보다 조금 매끄럽게 나왔습니다. 배경은 건드리지 않아 뒤편 술병 진열대는 원래의 압축 블록을 그대로 유지했습니다.
크기도 바뀌지 않습니다. Face Enhancer는 보낸 해상도에서 얼굴을 복원합니다. 픽셀 수까지 늘리려면 Image Upscaler(/models/image-upscaler-v1)를 사용하십시오.
얼굴은 실제 사람이고 적당히 크며 또렷하게 보일 때 가장 잘 개선됩니다. 원본이 일러스트·애니메이션이거나 얼굴이 작고 가려졌거나 심하게 흐리면 Face Enhancer가 복원에 쓸 정보가 적어 Face Enhancer의 정지 사진 얼굴 디테일 복원의 개선 폭이 제한됩니다.
작업 흐름
호출은 비동기입니다. 작업을 만들고 종료 상태가 될 때까지 폴링한 뒤 플랫폼 스토리지에서 이미지를 받으십시오. 요청 1건에 이미지 1장이 돌아오며, 요금은 이미지 1장당 정액이고 실패한 요청은 과금되지 않습니다.
팁
- 얼굴이 적당히 크고 또렷하게 보이는 사진에서 시작하십시오. 폭이 수십 픽셀에 불과한 얼굴은 복원할 정보가 거의 없습니다.
- 최대 3개의 얼굴을 큰 얼굴부터 복원합니다. 그 밖의 얼굴은 그대로 남습니다.
- 결과를 다시 편집하거나 압축할 예정이라면
png를 쓰십시오. 손실 압축을 한 번 더 거치지 않지만 파일이 더 큽니다. 파일 형식은 요금에 영향을 주지 않습니다. - 눈과 피부 주변을 원본과 원래 크기에서 비교하십시오. 테스트 결과는 실제 사진보다 조금 매끄러웠으니 원본 파일을 보관하십시오.
- 얼굴과 함께 픽셀 수도 늘려야 한다면 사진에 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/face-enhancer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg"
}
}'
# 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 레퍼런스에서 확인하세요.
