Video Eraser API로 자막 및 워터마크 제거하기

550W 개발자 API가 실제로 지원하는 기능

550W 개발자 API를 사용하면 백엔드에서 사용자를 수동 편집기에 보내지 않고도 비디오 자막 또는 텍스트 삭제 작업과 이미지 워터마크 제거 작업을 제출할 수 있습니다. 이 API는 크리에이터 플랫폼, 현지화 파이프라인, 미디어 라이브러리 및 조직이 소유하거나 편집 권한을 보유한 콘텐츠를 반복적으로 처리하는 내부 도구를 위해 설계되었습니다.

비디오 자막 및 텍스트 삭제

비디오의 경우 /open/uploadVideo를 통해 MP4 또는 MOV 영상물을 제출하거나 공개 videoUrl을 /open/submitTask에 제공할 수 있습니다. 요청에는 비디오 해상도, 재생 시간 및 복원할 영역(사각형)이 포함됩니다. 비디오 작업은 비동기적으로 실행되며 /open/taskDetail 또는 /open/taskList를 통해 상태를 확인할 수 있습니다.

이미지 워터마크 제거

이미지의 경우 /open/removeImageWatermark는 최대 50MB의 JPG, PNG, BMP, WebP, AVIF, TIFF 또는 SVG 파일을 허용합니다. 결과를 기다리거나 나중에 조회할 수 있도록 처리 작업만 반환할 수 있습니다. Eraser 개발자 API는 비디오 링크 워터마크 다운로드를 제공하지 않으므로, 통합 시 해당 기능을 약속하지 않도록 해야 합니다.

승인된 비디오 자막/텍스트 정리 및 이미지 워터마크 제거에 API를 사용하고, 지원되지 않는 비디오 링크 워터마크 워크플로우를 제품 약속에 포함하지 마세요.

프로덕션 준비 완료된 요청 흐름

모든 요청은 userNo 및 apiKey로 인증됩니다. 두 값을 모두 서버에 보관하세요: API 키를 브라우저나 모바일 클라이언트 코드에 배치하면 사용자와 확장 프로그램에 의해 복구될 수 있습니다. 비디오는 먼저 업로드하거나 공개적으로 접근 가능한 HTTPS URL로 제공할 수 있습니다.

인증 및 업로드

width, height, duration 및 x1, y1, x2, y2와 함께 /open/submitTask를 제출하세요. 긴밀한 사각형은 전체 화면 복원보다 더 많은 디테일을 보존하는 경향이 있습니다. 지원되는 워크플로우에 보수적 복원이 필요한 경우 mode=protect를 사용하고, 처리 전에 오디오를 제거해야 하는 경우에만 removeAudio를 사용하세요.

멱등성 작업 제출

128자 이하의 Idempotency-Key를 전송하여 재시도 안전하게 작업을 생성하세요. 제출 후 연결이 끊어지면 두 번째 과금 작업을 생성하는 대신 동일한 키로 재시도하세요. 반환된 taskId를 자체 자산 ID와 함께 저장하세요.

결과 수신 및 검증

비동기 전달을 위해 공개 HTTPS callbackUrl을 제공하세요. 웹훅은 작업이 최종 상태에 도달하면 실행됩니다. 핸들러는 빠르게 확인 응답하고 /open/taskDetail을 통해 작업을 다시 확인하며, 반복적인 웹훅 전달을 정상적인 것으로 처리해야 합니다. 폴링은 콜백이 지연될 때 복구 경로로 유용하게 활용됩니다.

서버 측 자격 증명, 멱등성, 지속 가능한 작업 ID 및 웹훅 검증이 재시도를 안전하고 관찰 가능하게 만듭니다.

입력 제한 및 품질 관리

업로드된 비디오는 MP4 및 MOV를 지원하며, 최대 파일 크기는 1GB, 재생 시간은 600초, 처리 해상도는 문서화된 해상도 규칙 내에서 최대 1080p입니다. 지원되지 않는 미디어가 과금 대기열에 들어가지 않도록 제출 전에 형식, 재생 시간, 해상도, 비트 심도 및 HDR 상태를 검증하세요.

크레딧 사용 전 검증

품질은 자막이나 텍스트 뒤에 무엇이 움직이느냐에 따라 달라집니다. 평평한 벽, 하늘, 천천히 변화하는 풍경은 일반적으로 손, 머리카락, 무늬가 있는 옷, 반사 또는 빠른 카메라 움직임보다 처리하기 쉽습니다. 엣지 케이스를 위한 검토 대기열을 구축하고 썸네일뿐만 아니라 전체 타임라인을 비교하세요.

어려운 영상물 검토

이미지 작업은 일반적인 웹 및 디자인 형식을 지원하며, 현재 API 페이지에 따라 성공적인 작업당 고정 크레딧이 부과됩니다. 원본 파일을 보존하고 결과를 파생물로 저장하세요. 워터마크 제거는 저작권 또는 상업적 사용 권한을 생성하지 않습니다.

지원되지 않는 입력을 초기에 거부하고 복원 영역이 중요한 움직이는 디테일을 가로질러 지나갈 때마다 인간 검토를 요구하세요.

과금, 실패 및 재시도 정책

비디오 자막 제거는 재생 시간과 해상도에 따라 과금됩니다. 현재 요금제는 720p 이하에서 초당 1.3 크레딧, 720p 초과 1080p 이하에서 초당 1.6 크레딧입니다. 따라서 30초의 1280×720 비디오는 약 39 크레딧, 30초의 1920×1080 비디오는 약 48 크레딧입니다. 대량 배치를 수락하기 전에 /open/queryCredits를 쿼리하세요.

제출 전 비용 추정

성공 응답에는 code와 message가 포함됩니다. 작업 응답은 추가적으로 status와 완료 시 resultUrl을 노출합니다. 실패한 작업은 failCode, failReason 및 refundStatus를 포함할 수 있습니다. 일시적인 전송 또는 내부 실패는 지수적 백오프로 재시도하되, 잘못된 매개변수, 지원되지 않는 미디어, 정지된 계정 또는 크레딧 부족 오류는 무조건 재시도하지 마세요.

안정적인 실패 필드 처리

제출 지연 시간, 완료 지연 시간, 실패율, 검토 거부율 및 승인된 자산당 비용을 기록하세요. 이러한 지표는 자동화가 단순히 수동 작업을 하류로 이동시키는 것이 아니라 워크플로우를 실제로 개선하고 있는지reveal합니다.

유용한 통합은 성공적인 HTTP 응답만이 아니라 승인된 출력과 실제 비용을 측정합니다.

4단계로 통합 출시하기

먼저 지역화된 550W 개발자 페이지에서 API 키를 생성하고 대표적인 비디오 하나를 제출하세요. 두 번째로 작업 조회를 구현하고 자체 제품에서 대기, 처리 중, 성공 및 실패 상태를 표시하세요. 세 번째로 멱등성과 폴링 복구가 포함된 웹훅을 추가하세요. 마지막으로 동시성을 높이기 전에 제어된 배치를 실행하고 모든 출력을 검토하세요.

확장 전 파일럿

별도의 개발 및 운영 제어를 사용하고, 노출된 자격 증명을 순환하며, 소스 미디어에 대한 접근을 제한하고, 결과에 대한 삭제 정책을 유지하세요. 명확한 수락 기준이 있는 팀은 편집 검토를 희생하지 않으면서 DAM, CMS, 현지화 대기열 또는 크리에이터 업로드 워크플로우에 API를 연결할 수 있습니다.