PopNowAPI
API 키 받기

PopNow

다음 합성을 위한 투명 영상 마스터

popnow/background-remover-video-v1/video-edit
  • 영상 배경 제거

Video Background Remover 소개

다음 합성을 위한 투명 영상 마스터.

POST /jobs/createTask에서 모델 이름을 popnow/background-remover-video-v1/video-edit(으)로 지정하면 호출할 수 있습니다. US$0.06부터.

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
background아니요배경을 유지, 제거 또는 교체. transparent · black · white · gray · red · green · blue · yellow · cyan · magenta · orange · 기본값: transparent
keep_original_audio아니요Keep the source audio in an output format that supports audio. GIF does not carry sound. 기본값: true
output_format아니요결과 파일 형식. webm_vp9 · mp4_h264 · mp4_h265 · mov_h265 · mov_proresks · mkv_h264 · mkv_h265 · mkv_vp9 · gif · 기본값: webm_vp9
video_url예작업할 영상.

가격

요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

옵션USD 입력 길이 초당
기본US$0.06

입력 길이는 초 단위로 올림하며 최소 1초로 계산해요.

실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.

API 빠른 시작

Video Background Remover API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 popnow/background-remover-video-v1/video-edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "popnow/background-remover-video-v1/video-edit",
  "input": {
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Video Background Remover API 질문

Video Background Remover API 요금은 얼마인가요?

Video Background Remover 가격은 US$0.06 /초입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.

API에서 Video Background Remover의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 영상 배경 제거: popnow/background-remover-video-v1/video-edit을(를) 넣으세요.

투명 출력을 요청하려면 어떤 설정을 사용하나요?

background=transparent와 output_format=webm_vp9를 사용하세요. 생성된 알파 마스터를 합성용으로 보관하고, 사용 전에 실제 채널을 확인하세요.

GIF에도 오디오 보존이 적용되나요?

아니요. GIF에는 오디오 트랙이 없습니다. GIF를 요청할 때는 keep_original_audio를 끄세요.

결과가 모든 브라우저에서 작동한다고 봐도 되나요?

아니요. 컨테이너와 코덱 지원은 서로 다릅니다. 결과를 사용할 브라우저나 애플리케이션에서 재생과 편집을 확인하세요.

Video Background Remover API의 제한은 무엇인가요?

입력 클립 최대 길이: 60 s. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 Video Background Remover을(를) 써 볼 수 있나요?

API 키 없이 Playground에서 API 달러 잔액으로 Video Background Remover을(를) 실행할 수 있습니다. 실행마다 해당 코드와 함께 개발자 기록에 저장됩니다.

모든 Video Background Remover 모델

Video Background Remover 더 알아보기