소개
흰색은 지울 영역, 검은색은 유지할 영역을 나타내는 이미지 마스크로 동영상 전체의 고정 영역을 지웁니다. 선택 사항인 지시문으로 해당 영역의 제거 작업을 설명할 수 있으며, 같은 마스크가 클립 전체에 적용됩니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 처리할 전체 동영상으로, 길이는 1~600초입니다. 선택 영역은 클립 전체에 걸쳐 처리됩니다. 1자 이상 |
mask_url | 예 | 동영상 프레임에 정렬된 하나의 정적 PNG 이미지입니다. 제거 영역은 흰색으로, 나머지 영역은 검은색으로 칠하세요. 1자 이상 |
prompt | 아니요 | 국소 제거 작업을 위한 선택 지침입니다. 시간 구간을 선택하거나 추적을 활성화하지는 않습니다. |
요금
$0.024 / 초
입력 클립 전체를 기준으로 초 단위로 올림하여 청구하며, 최소 청구 시간은 3초입니다. 이 엔드포인트는 1~600초의 클립을 허용하며, 마스크 크기는 청구 시간을 줄이지 않습니다.
활용 사례
영상 → 영상 편집 → 영상
영상 편집
영상
비동기 작업
프롬프트 가이드 및 실전 팁
소개
Video Eraser는 동영상 클립 전체에 걸쳐 정적 이미지 마스크 안의 내용을 제거합니다. video_url과 mask_url을 전송하고, 필요하면 제거 작업을 설명하는 짧은 prompt를 추가하세요. 고정된 자막 띠나 화면의 같은 영역에 머무르는 기타 불필요한 요소에 적합합니다. 결과 배경은 추론을 통한 채움이며, 가려진 원본 픽셀을 복원한 것이 아닙니다.
주요 기능 및 특징
클립 전체에 적용되는 고정 영역
마스크는 정지 이미지입니다. 흰색은 지울 영역, 검은색은 유지할 영역을 표시합니다. 제공한 동영상 전체에서 같은 화면 영역에 적용됩니다. 시작 시간 필드, 종료 시간 필드 또는 움직이는 객체의 추적 제어 기능은 없습니다. 흰색 영역 밖으로 이동한 자막은 해당 마스크로 처리되지 않습니다. 선택한 영역을 지나가는 내용도 채움으로 인해 바뀔 수 있습니다.
마스크와 함께 제공하는 선택 설명
간단한 설명으로 무엇을 제거할지, 그 주변에 무엇이 있는지 명확히 할 수 있습니다. 이 엔드포인트에서는 영역을 명확히 지정하기 위해 마스크가 필수입니다. 처리 요금은 입력 클립 전체를 기준으로 초 단위로 올림하여 계산하며, 최소 청구 시간은 3초입니다. 허용되는 원본 클립 길이는 1~600초입니다. 마스크를 작게 해도 청구되는 동영상 길이는 줄어들지 않습니다.
활용 사례
고정된 자막 띠 제거
자신의 영상에 이미 입혀진 자막이라면 자막 띠를 표시하고, 텍스트가 나타나는 모든 구간을 확인하세요. 배경이 정적인 장면부터 결과를 확인하면 도움이 됩니다. 프로젝트에서 자막이 아직 편집 가능한 텍스트 레이어라면, 픽셀 재구성을 선택하기 전에 해당 레이어를 직접 제거하세요.
고정 오버레이 정리
편집 중인 영상의 모서리에 있는 불필요한 오버레이에는 꼭 맞는 마스크를 사용하세요. 사람이나 제품이 선택 영역 뒤를 지나가거나 카메라가 움직이는 프레임을 확인하세요. 이런 순간에는 변화하는 내용을 추론해 채워야 하므로, 단일 미리보기 프레임에서는 뚜렷하지 않은 깜빡임이나 경계 왜곡이 드러날 수 있습니다.
프롬프트 가이드 및 활용 팁
명확한 마스크 만들기
원본 프레임에 정렬된 PNG 마스크를 준비하세요. 제거 영역 안은 흰색, 바깥은 검은색으로 만듭니다. 제출 전에 첫 프레임, 중간 프레임, 마지막 프레임에서 위치를 확인하세요. 특히 얼굴이나 제품의 중요한 세부 부분과 겹칠 때는 흰색 영역을 필요 이상으로 크게 만들지 마세요. 마스크는 정적이며 클립 전체에 영향을 줍니다. 움직이는 자막을 따라가거나 편집을 선택한 시간 구간으로 제한할 수 없습니다.
국소 편집 내용을 설명하고 결과 비교하기
“고정된 자막 띠를 제거하고 주변 배경으로 채워 주세요” 같은 선택 지시문으로 새로운 장면을 만들어 내지 않고도 원하는 변경을 설명할 수 있습니다. 출력을 원본과 일반 재생 속도로 비교하고, 복잡한 움직임이 있는 구간 전후는 프레임별로도 비교하세요. 지운 영역뿐 아니라 마스크 밖의 영역, 클립 길이, 프레임 레이트와 소리도 확인하세요. 원본 오디오 보존과 마스크 밖의 픽셀 단위 보존은 검증되지 않았으므로 원본 파일을 보관하세요.
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-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"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 레퍼런스에서 확인하세요.