소개
기존 클립에서 전경을 분리하고 투명 배경 또는 단색 배경을 선택하세요. 기본 요청은 원본 오디오가 포함된 투명 WebM VP9입니다.
| 항목 | 값 |
|---|---|
| 입력 | 영상 |
| 출력 | 영상 |
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
video_url | 예 | 1~60초의 원본 클립입니다. 출력은 감지된 전경을 분리하며, 자르기 제어 기능은 없습니다. 1자 이상 |
background | 아니요 | 투명 배경 또는 열 가지 단색 중 하나를 선택하세요. 투명 출력에는 알파를 지원하는 형식이 필요합니다. |
output_format | 아니요 | 컨테이너 및 코덱 프리셋입니다. 기본값은 WebM VP9입니다. |
keep_original_audio | 아니요 | 출력에 원본 오디오를 포함하도록 요청하며, 기본적으로 켜져 있습니다. 무음 클립을 원하면 끄세요. 기본값: |
요금
$0.06 / 초
입력 동영상의 초 단위 길이를 정수 초로 올림하여 초당 과금합니다. 이 엔드포인트는 1~60초 클립을 허용합니다. 배경, 형식 및 오디오 선택은 이 길이 기준 규칙에 영향을 주지 않습니다.
활용 사례
영상 → 영상 편집 → 영상
영상 편집
영상
비동기 작업
프롬프트 가이드 및 실전 팁
소개
동영상 배경 제거는 기존 동영상에서 전경을 분리하여 합성하거나 단색 배경에 배치할 수 있게 합니다. video_url을 보내고 배경 및 내보내기 형식을 선택하세요. 기본 요청은 투명 WebM VP9를 지정하고 원본 오디오를 유지합니다. 이 엔드포인트는 1~60초의 원본 클립을 허용하며, 프롬프트로 새로운 장면을 생성하지 않습니다.
주요 기능 및 특징
배경과 형식 선택으로 결정되는 투명도
background를 transparent로 설정하고 알파를 지원하는 형식을 사용하세요. WebM VP9, MOV ProRes 4444, MKV VP9 및 GIF는 문서상 알파를 지원하는 옵션입니다. 여기서는 MP4 프리셋과 MKV H.264 또는 H.265 프리셋에 알파가 포함되지 않으며, 호환되지 않는 투명 출력 요청은 거부될 수 있습니다. MOV H.265는 문서상 부분적으로만 지원하므로 기본 투명 작업 흐름에는 WebM VP9를 사용하고 합성 전에 실제 출력을 확인하세요.
단색 배경과 원본 사운드
검정, 흰색, 회색, 빨강, 초록, 파랑, 노랑, 시안, 마젠타 또는 주황을 선택할 수도 있습니다. keep_original_audio는 결과에 원본 오디오를 요청할지 여부를 제어합니다. GIF에는 오디오 트랙을 포함할 수 없으므로 이를 선택할 때는 오디오 보존을 끄세요. 컨테이너, 코덱 및 배경 선택은 길이 기반 과금 규칙에 영향을 주지 않습니다. 과금에는 입력 초 수를 올림하여 사용하며, 이 엔드포인트에는 자르기 또는 출력 해상도 제어 기능이 없습니다.
활용 사례
프레젠테이션 위에 발표자 배치하기
발표자와 배경이 명확하게 구분되는 짧은 클립으로 시작하세요. 투명 WebM VP9를 요청한 다음, 해당 형식을 지원하는 편집기에서 결과를 슬라이드나 장면 위에 배치하세요. 합성 영상을 공개하기 전에 어두운 배경과 밝은 배경 모두에서 머리카락과 움직임으로 흐려진 가장자리를 확인하세요.
새 레이아웃에 사용할 제품 클립 준비하기
제품을 원래 환경에서 분리하여 카탈로그 레이아웃이나 소셜 미디어용 편집에 영상을 재사용하세요. 투명도가 필요하지 않다면 단색 내보내기가 유용할 수 있습니다. 반사 표면과 미세한 가장자리는 면밀히 검토해야 합니다. 결과는 처리된 마스크이므로 체크무늬 미리보기만이 아니라 실제로 사용할 배경에 놓고 평가해야 합니다.
프롬프트 가이드 및 활용 팁
최종 전달 형식을 신중하게 선택하기
기본 동영상 작업 흐름에서는 background=transparent, output_format=webm_vp9 및 keep_original_audio=true를 유지하세요. 다른 프리셋은 편집기에서 가져올 수 있는지 확인한 후에만 선택하세요. 웹 재생 지원은 브라우저와 코덱에 따라 다릅니다. 다운로드에 성공해도 인라인 미리보기나 이후 편집이 작동한다는 뜻은 아닙니다. 공유용으로 투명도를 합쳐 평면화한 별도 미리보기를 만들 때에도 투명 마스터를 보관하세요.
투명도와 전체 클립 검증하기
실제 알파 채널을 확인하고 결과를 검정, 흰색 및 채도가 높은 색상 위에 합성하세요. 파일에 체크무늬나 검은 직사각형이 보이는 것만으로는 투명도가 작동한다는 증거가 되지 않습니다. 전체 움직임에서 가장자리 변화를 검토하고 길이, 프레임 크기 및 오디오 동기화를 원본과 비교하세요. 파일 이름이나 선택한 옵션만으로 알파 유무를 판단하지 마세요. 이 연동은 아직 미디어 품질 또는 브라우저 호환성 시험이 완료되지 않았으므로, 실제로 사용할 작업 흐름에서 결과를 검증하세요.
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/background-remover-video-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"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 레퍼런스에서 확인하세요.
