소개
이 엔드포인트가 하는 일
영상 1편을 받아 프레임마다 최대 3개의 얼굴을 큰 얼굴부터 복원하고 선명하게 다듬은 사본을 돌려줍니다. 결과는 프레임에서 프레임으로 넘어가도 안정적으로 유지됩니다. 움직임, 화면 구도, 길이와 원본 오디오 트랙은 그대로 남고 해상도도 바뀌지 않습니다. 프롬프트는 없습니다.
중요한 입력
video_url이 클립입니다. MP4 업로드나 공개 URL을 쓸 수 있으며, 길이는 3초에서 5분 사이여야 합니다. 이 범위를 벗어난 클립은 과금되기 전에 거부됩니다. Video Face Enhancer에는 원본에서 충분히 크고 선명하게 보이는 실제 인물의 얼굴을 선택하며 Video Face Enhancer의 프레임별 얼굴 복원는 멀거나 가려진 얼굴보다 이런 디테일에서 더 큰 효과를 얻습니다.
돌려받는 것
요청 1건당 보낸 해상도, 프레임 레이트, 길이 그대로이고 원본 오디오가 포함된 영상 1편이 작업이 끝난 뒤 플랫폼 스토리지에서 제공됩니다. 더 많은 픽셀이 필요하면 /models/video-upscaler-v1을 사용하십시오.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 엔드포인트 | 영상 편집 |
| 얼굴 수 | 프레임당 최대 3개, 큰 얼굴부터 |
| 조절 항목 | 프롬프트 없음. 클립이 요청의 전부 |
| 과금 | 입력 클립의 초 단위, 최소 3초 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 복원할 클립입니다. MP4 업로드나 파일의 공개 링크를 넣으며, 길이는 3초에서 5분 사이여야 합니다. 1자 이상 |
요금
$0.012 / 출력 초
입력 클립의 초 단위로 과금하며, 소수점 이하는 다음 정수 초로 올리고 최소 3초입니다. 업로드 파일은 자체 길이만큼, URL은 전달 전까지 최대 5분 기준으로 금액을 잡아 두었다가 차액을 풀어 줍니다. 실패한 요청은 과금되지 않습니다.
활용 사례
팟캐스트와 인터뷰 클립
말하는 사람을 정면에서 찍은 영상은 업로드를 위해 강하게 압축되면 얼굴의 세부가 가장 먼저 사라집니다. 한 번 처리해 눈, 치아와 헤어라인을 되살리면서, 방, 카메라 구도와 소리는 그대로 유지하십시오.
오래되었거나 과하게 압축된 영상
여러 번 저장되고 공유되고 다시 인코딩된 클립은 얼굴 주변이 흐리고 뭉개져 보입니다. 프레임마다 최대 3개의 얼굴이 복원되므로, 뚜렷한 화자가 한두 명인 클립에 가장 잘 맞습니다.
나중에 키울 영상
먼저 얼굴을 정리한 뒤, 더 큰 화면에 맞추려고 픽셀 수가 더 필요하면 /models/video-upscaler-v1의 Video Upscaler를 사용하십시오.
프롬프트 가이드 및 실전 팁
클립 확인
길이가 3초에서 5분 사이인 MP4이며, 실제 사람 얼굴이 적당히 크고 또렷하게 보여야 합니다. 먼저 필요한 부분만 잘라 두십시오.
video_url보내기video_url은 MP4 업로드나 공개 링크입니다. 이것이 유일한 항목이며 프롬프트도, 조절할 것도 없습니다.
폴링 후 비교
호출은 비동기입니다. 작업을 만들고, 끝날 때까지 폴링한 뒤, 플랫폼 스토리지에서 영상을 받으십시오. 원본과 일반 속도, 일시 정지한 프레임에서 비교하고, 오디오가 온전한지 확인하십시오.
소개
Video Face Enhancer는 클립의 모든 프레임에서 얼굴을 복원하고 선명하게 다듬습니다. video_url을 보내면 도구가 프레임마다 최대 3개의 얼굴을 큰 얼굴부터 찾아, 강한 압축이나 흐림으로 사라진 세부를 되살립니다. 프레임에서 프레임으로 넘어가도 결과가 안정적으로 유지됩니다. 움직임, 화면 구도, 길이와 원본 오디오 트랙은 그대로 남고, 클립은 보낸 해상도로 돌아옵니다. 허용되는 클립은 길이 3초에서 5분 사이의 MP4 파일이며, 프롬프트는 없습니다.
주요 기능 및 특징
모든 프레임에서 정리되는 얼굴
복원은 단일 정지 이미지가 아니라 클립 전체에 적용됩니다. 테스트에서는 팟캐스트 진행자를 찍은 5초짜리 640×360 클립을 강한 H.264 압축으로 열화시켰습니다. 약 21초의 처리 시간 후 640×360, 24 fps, 길이 5.0초를 그대로 유지한 채 돌아왔습니다. 모든 프레임에서 눈, 치아와 헤어라인이 더 선명했고 깜박이지 않았으며, 진행자는 여전히 같은 사람으로 알아볼 수 있었습니다.
나머지는 그대로 유지
오디오, 움직임, 화면 구도와 길이는 유지되고, 얼굴 주변 영역은 건드리지 않습니다. 테스트에서 진행자 뒤편의 방은 바뀌지 않았습니다. 이 도구는 영상을 키우지 않습니다. 픽셀 수까지 늘리려면 Video Upscaler(/models/video-upscaler-v1)를 사용하십시오.
과금은 클립 길이를 따릅니다
과금은 입력 클립의 초 단위이며, 소수점 이하는 다음 정수 초로 올리고 최소 3초입니다. 3초보다 짧거나 5분보다 긴 클립은 과금되기 전에 거부됩니다. 길이를 읽을 수 있는 업로드 파일이라면 그 길이만큼 금액을 잡아 두고, URL이라면 전달될 때까지 최대 5분 기준 금액을 잡아 두었다가 차액을 풀어 줍니다. 실패한 요청은 과금되지 않습니다.
활용 사례
팟캐스트와 인터뷰 클립
말하는 사람을 정면에서 찍은 영상은 업로드를 위해 강하게 압축되면 얼굴의 세부가 가장 먼저 사라집니다. 클립을 한 번 처리해 눈, 치아와 헤어라인을 되살리면서, 방, 카메라 구도와 소리는 그대로 유지하십시오.
오래되었거나 과하게 압축된 영상
여러 번 저장되고 공유되고 다시 인코딩된 클립은 얼굴 주변이 흐리고 뭉개져 보입니다. 프레임마다 최대 3개의 얼굴이 큰 얼굴부터 복원되므로, 뚜렷한 화자가 한두 명인 클립에 가장 잘 맞습니다.
나중에 키울 영상
먼저 얼굴을 정리한 뒤, 더 큰 화면에 맞추려고 픽셀 수가 더 필요하면 Video Upscaler(/models/video-upscaler-v1)를 사용하십시오.
프롬프트 가이드 및 활용 팁
프롬프트는 없습니다. 클립을 고르십시오
입력은 video_url 하나뿐이며, MP4 업로드나 공개 링크로 길이는 3초에서 5분 사이여야 합니다. 과금이 보낸 길이를 따르므로, 보내기 전에 필요한 부분만 잘라 두십시오.
복원 가능한 얼굴을 고르십시오
Video Face Enhancer에는 원본에서 충분히 크고 선명하게 보이는 실제 인물의 얼굴을 선택하며 Video Face Enhancer의 프레임별 얼굴 복원는 멀거나 가려진 얼굴보다 이런 디테일에서 더 큰 효과를 얻습니다. 원본이 일러스트·애니메이션이거나 얼굴이 작고 가려졌거나 심하게 흐리면 Video Face Enhancer가 복원에 쓸 정보가 적어 Video Face Enhancer의 프레임별 얼굴 복원의 개선 폭이 제한됩니다. 한 클립에 얼굴이 세 개 넘게 동시에 보이면 가장 큰 세 얼굴만 복원되고 나머지는 그대로 남습니다.
결과를 원본과 비교하십시오
결과 영상은 일반 속도와 일시 정지한 프레임에서 함께 보고, 얼굴뿐 아니라 오디오, 길이와 프레임 레이트도 확인하십시오. 이미지 버전의 도구는 피부가 실제 사진보다 조금 매끄럽게 나왔으니, 움직이는 얼굴에서도 같은 부드러움이 있는지 살펴보십시오. 배경은 건드리지 않으므로 그곳의 압축 블록은 남습니다. 원본 파일은 보관하십시오.
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-video-v1/video-edit",
"input": {
"video_url": "https://example.com/reference.mp4"
}
}'
# 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 레퍼런스에서 확인하세요.
