소개
엔드포인트 기능
두 모드 중 하나로 영상 1개를 복원합니다. decompress는 매크로블록, 링잉, 밴딩, 색 번짐을 제거하고 deblur는 초점이 흐린 영상을 선명하게 합니다. 구도, 움직임, 길이, 오디오는 유지합니다.
주요 입력
video_url은 최대 120초 클립입니다. restore_mode로 복원 방식, resolution으로 원본 이하의 출력 크기를 선택합니다. prompt와 seed는 선택 사항입니다.
반환 결과
원본 비율, 프레임레이트, 오디오를 유지한 MP4 1개입니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
| 엔드포인트 | 영상 편집 |
| 모드 | decompress(인코딩 손상) 또는 deblur(초점 흐림) |
| 선택 사항 | 장면 설명과 seed |
| 요금 | 해상도별 원본 초당 과금, 최소 3초분 |
핵심 기능 및 하이라이트
매크로블록 제거와 얼굴 재구성
4초 온실 영상을 116 kbps로 압축해 여성의 얼굴이 블록으로 깨지게 했습니다. decompress 모드는 길이와 프레임레이트를 유지하며 곱슬머리, 미소, 난초가 선명한 깨끗한 854×480 클립을 반환했습니다.
흐린 투샷을 선명하게
초점 오류처럼 흐리게 만든 와인 저장고 대화 영상은 얼굴, 머리카락, 나무통이 선명해졌습니다. 두 사람의 위치와 움직임은 유지되었습니다.
먼저 복원하고 나중에 확대
복원은 원본 크기 이하에서 작동합니다. 복원 클립도 키워야 한다면 Video Upscaler로 보냅니다. 블록이 있는 클립을 확대하면 블록만 커집니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 복원할 최대 120초 클립입니다. MP4·WebM 업로드 또는 직접 링크를 전달합니다. 1자 이상 |
restore_mode | 아니요 | decompress(기본값)는 낮은 비트레이트 영상의 매크로블록, 링잉, 밴딩, 색 번짐을 제거합니다. deblur는 초점 흐림을 선명하게 하지만 모션 블러는 보정하지 않습니다. |
prompt | 아니요 | 선택 사항입니다. "a man and a woman talking in a wine cellar" 같은 짧은 설명으로 올바른 세부를 유지하도록 돕습니다. 1000자 이하 |
resolution | 아니요 | 출력 해상도는 480p, 720p(기본값), 1080p입니다. 비율을 유지하며 원본보다 커지지 않습니다. |
seed | 아니요 | 재현 가능한 결과를 위한 선택적 정수입니다. 비워 두면 무작위 seed를 사용합니다. |
요금
선택한 출력 해상도 요금으로 원본 길이를 초 단위로 올림해 최소 3초분을 과금합니다. 120초를 넘으면 제출 시 거부됩니다. 모드, prompt, seed는 요금에 영향을 주지 않으며 실패한 요청은 과금하지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.024 / 초 |
| $0.048 / 초 |
| $0.12 / 초 |
활용 사례
여러 번 공유된 영상 복원
여러 앱과 재업로드를 거친 영상에는 블록과 번짐이 생깁니다. decompress 모드로 얼굴, 머리카락, 질감을 정리합니다.
초점이 흐린 테이크 살리기
자동초점이 헤매거나 피사체가 초점면을 벗어났다면 deblur 모드로 재촬영 없이 쓸 만한 테이크를 복구할 수 있습니다.
업스케일 전 처리
먼저 원본 크기로 복원한 뒤 1080p나 4K가 필요하면 깨끗한 클립을 Video Upscaler로 보냅니다.
프롬프트 가이드 및 실전 팁
손상에 맞는 모드를 선택합니다
강한 압축으로 생긴 매크로블록, 밴딩, 색 번짐에는 decompress를 사용합니다. 렌즈 초점이 맞지 않아 흐린 영상에는 deblur를 사용하며 모션 블러는 보정하지 않습니다.
출력 해상도를 설정합니다
480p, 720p, 1080p 중 선택합니다. 비율을 유지하고 원본보다 커지지 않으므로 원본 높이 이하의 해상도를 고릅니다. 요금은 선택한 해상도를 따릅니다.
세부가 중요하면 장면을 설명합니다
선택적 prompt에 "a woman with curly hair in a greenhouse full of orchids"처럼 쓰면 올바른 세부를 유지하는 데 도움이 됩니다. 결과를 재현하려면 seed를 추가합니다.
소개
Video Restorer는 영상 속 내용을 바꾸지 않고 손상된 영상을 정리합니다. 낮은 비트레이트와 반복 업로드로 압축된 클립에는 decompress, 렌즈 초점이 맞지 않은 클립에는 deblur를 선택합니다. 피사체, 구도, 움직임은 유지합니다.
요청
{
"video_url": "https://example.com/clip.mp4",
"restore_mode": "decompress",
"resolution": "720p",
"prompt": "a woman with curly hair in a greenhouse full of orchids"
}
video_url만 필수입니다. restore_mode 기본값은 decompress, resolution은 720p입니다. 비율을 유지하고 원본보다 커지지 않으므로 480p 클립은 더 높게 요청해도 480p로 반환됩니다.
테스트 결과
4초짜리 854×480 온실 클립을 116 kbps로 압축해 여성의 얼굴이 블록으로 깨지게 했습니다. 480p decompress 모드에서는 약 55초 후 얼굴, 곱슬머리, 난초가 깨끗해지고 길이 4초, 24 fps, 스테레오 오디오가 유지되었습니다. 초점 오류를 모방해 흐리게 만든 4초 와인 저장고 클립은 deblur 모드에서 약 72초 후 얼굴과 통이 선명해졌습니다.
작업 흐름
호출은 비동기식입니다. 작업을 생성하고 완료까지 폴링한 뒤 SpicyAPI 저장소에서 MP4를 다운로드합니다. 선택한 해상도에 따라 원본 길이로 초당 과금하며 실패한 요청은 과금하지 않습니다.
팁
resolution은 원본 높이 이하로 선택합니다. 더 높은 설정은 픽셀을 늘리지 않고 요금만 올립니다.deblur는 초점 흐림용이며 모션 블러와 흔들림은 보정하지 않습니다.- 복원 클립을 키우려면 이후 Video Upscaler (
/models/video-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/video-restorer-v1/video-edit",
"input": {
"resolution": "720p",
"restore_mode": "decompress",
"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 레퍼런스에서 확인하세요.


