자막 영역 지우기Video Eraser 소개
클립 전체에서 고정 영역 지우기.
POST /jobs/createTask에서 모델 이름을 popnow/video-eraser-v1/video-edit(으)로 지정하면 호출할 수 있습니다. US$0.024부터.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
mask_url | 예 | 바꿀 영역을 칠합니다. |
prompt | 아니요 | Optional short description of the objects or area to remove and the surrounding context. |
video_url | 예 | 작업할 영상. |
가격
요금은 미국 달러 기준입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
| 옵션 | USD 입력 길이 초당 |
|---|---|
| 기본 | US$0.024 |
입력 길이는 초 단위로 올림하며 최소 3초로 계산해요.
실행 전에 같은 요청 본문을 POST /jobs/quote로 보내면 예상 요금과 최대 요금을 미국 달러로 확인할 수 있습니다. 견적만으로는 작업이 실행되거나 요금이 청구되지 않습니다.
API 빠른 시작
Video Eraser API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인하고 API 콘솔에서 키를 만드세요. 키는 sk-popnow-로 시작하며 API 호출은 별도의 달러 잔액을 사용합니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/video-eraser-v1/video-edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 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/video-eraser-v1/video-edit",
"input": {
"prompt": "Remove the subtitles inside the white mask. Preserve the rest of the video.",
"video_url": "https://media.popnow.ai/api-examples/video-eraser/subtitles-e1128ca9.mp4",
"mask_url": "https://media.popnow.ai/api-examples/video-eraser/subtitles-mask-b701fc56.png"
}
}'
# 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 Eraser API 질문
Video Eraser API 요금은 얼마인가요?
Video Eraser 가격은 US$0.024 /초입니다. API는 별도의 미국 달러 잔액을 사용합니다. 웹사이트 크레딧은 API에 사용할 수 없으며, API 잔액과 웹사이트 크레딧 간 전환도 지원하지 않습니다. 작업이 접수되면 견적의 최대 금액을 API 잔액에서 예약합니다. 완료 후 실제 사용량으로 정산하고 남은 예약 금액을 해제합니다. 청구액은 예약 금액을 넘지 않으며, 작업이 실패하면 예약 금액을 해제합니다.
API에서 Video Eraser의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 자막 영역 지우기: popnow/video-eraser-v1/video-edit을(를) 넣으세요.
시간 구간을 선택할 수 있나요?
아니요. 동일한 정적 영역이 제공한 클립 전체에 적용되며, 시간을 선택하는 필드는 없습니다.
마스크가 움직이는 자막을 추적하나요?
아니요. 마스크는 프레임의 고정 좌표에 머무릅니다. 마스크 밖으로 이동한 부분은 처리되지 않습니다.
가려진 원본 화면을 복원하나요?
아니요. 마스크 영역은 추론한 내용으로 채워집니다. 움직임, 경계와 나머지 화면을 원본과 비교해 확인하세요.
Video Eraser API의 제한은 무엇인가요?
입력 클립 최대 길이: 600 s. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Video Eraser을(를) 써 볼 수 있나요?
API 키 없이 Playground에서 API 달러 잔액으로 Video Eraser을(를) 실행할 수 있습니다. 실행마다 해당 코드와 함께 개발자 기록에 저장됩니다.
