API Video Eraser để xóa phụ đề và hình mờ khỏi video

Những gì API dành cho nhà phát triển 550W thực sự hỗ trợ

API dành cho nhà phát triển 550W cho phép backend gửi các tác vụ xóa phụ đề hoặc văn bản trên video và các tác vụ xóa hình mờ hình ảnh mà không cần đưa người dùng qua trình chỉnh sửa thủ công. Nó được thiết kế cho các nền tảng dành cho nhà sáng tạo, quy trình bản địa hóa, thư viện media và các công cụ nội bộ xử lý nội dung lặp đi lặp lại mà tổ chức sở hữu hoặc có giấy phép chỉnh sửa.

Xóa phụ đề và văn bản trên video

Đối với video, hãy tải lên footage MP4 hoặc MOV qua /open/uploadVideo hoặc cung cấp videoUrl công khai tới /open/submitTask. Yêu cầu bao gồm kích thước video, thời lượng và hình chữ nhật cần sửa. Các tác vụ video chạy không đồng bộ và có thể được kiểm tra qua /open/taskDetail hoặc /open/taskList.

Xóa hình mờ hình ảnh

Đối với hình ảnh, /open/removeImageWatermark chấp nhận các tệp JPG, PNG, BMP, WebP, AVIF, TIFF hoặc SVG có dung lượng tối đa 50 MB. Nó có thể chờ kết quả hoặc trả về tác vụ xử lý để tra cứu sau. API dành cho nhà phát triển Eraser không cung cấp tính năng tải xuống hình mờ từ liên kết video, vì vậy các tích hợp không nên hứa hẹn về khả năng đó.

Sử dụng API để xóa phụ đề/văn bản trên video và xóa hình mờ hình ảnh được ủy quyền; loại trừ các quy trình xóa hình mờ từ liên kết video không được hỗ trợ khỏi lời hứa sản phẩm của bạn.

Quy trình yêu cầu sẵn sàng cho sản xuất

Mọi yêu cầu đều được xác thực bằng userNo và apiKey. Giữ cả hai giá trị trên máy chủ của bạn: đặt khóa API trong mã trình duyệt hoặc ứng dụng di động khiến người dùng và tiện ích mở rộng có thể khôi phục được. Video có thể được tải lên trước hoặc cung cấp dưới dạng URL HTTPS công khai.

Xác thực và tải lên

Gửi /open/submitTask với width, height, duration và x1, y1, x2, y2. Hình chữ nhật vừa khớp thường bảo toàn nhiều chi tiết hơn so với sửa toàn màn hình. Sử dụng mode=protect khi quy trình công việc được hỗ trợ yêu cầu tái tạo thận trọng và chỉ sử dụng removeAudio khi âm thanh cần được loại bỏ trước khi xử lý.

Gửi tác vụ có tính idempotency

Gửi Idempotency-Key có độ dài không quá 128 ký tự để tạo an toàn khi thử lại. Nếu kết nối bị ngắt sau khi gửi, hãy thử lại với cùng khóa thay vì tạo tác vụ có thể tính phí thứ hai. Lưu trữ taskId được trả về cùng với ID tài sản của riêng bạn.

Nhận và xác minh kết quả

Để nhận kết quả không đồng bộ, hãy cung cấp callbackUrl HTTPS công khai. Webhook kích hoạt khi tác vụ đạt trạng thái cuối cùng. Trình xử lý của bạn nên xác nhận nhanh chóng, xác minh tác vụ một lần nữa qua /open/taskDetail và coi việc webhook được gửi nhiều lần là bình thường. Polling vẫn hữu ích như một con đường khôi phục khi callback bị trì hoãn.

Thông tin xác thực phía máy chủ, tính idempotency, ID tác vụ bền vững và xác minh webhook giúp việc thử lại an toàn và có thể quan sát được.

Giới hạn đầu vào và kiểm soát chất lượng

Các video được tải lên hỗ trợ MP4 và MOV, dung lượng tệp tối đa 1 GB, thời lượng tối đa 600 giây và xử lý lên đến 1080p trong các quy tắc kích thước đã ghi nhận. Xác thực định dạng, thời lượng, kích thước, độ sâu bit và trạng thái HDR trước khi gửi để phương tiện không được hỗ trợ không bao giờ được đưa vào hàng đợi trả phí.

Xác thực trước khi sử dụng tín dụng

Chất lượng phụ thuộc vào những gì di chuyển phía sau phụ đề hoặc văn bản. Tường phẳng, bầu trời và phong cảnh thay đổi chậm thường dễ xử lý hơn so với tay, tóc, quần áo có hoa văn, phản chiếu hoặc chuyển động máy ảnh nhanh. Xây dựng hàng đợi xem lại cho các trường hợp phức tạp và so sánh toàn bộ timeline, không chỉ một hình thu nhỏ.

Xem lại footage khó xử lý

Các tác vụ hình ảnh hỗ trợ các định dạng web và thiết kế phổ biến và tính phí một số tín dụng cố định cho mỗi tác vụ thành công theo trang API hiện tại. Lưu giữ tệp nguồn và lưu kết quả dưới dạng sản phẩm phái sinh; việc xóa hình mờ không tạo ra quyền bản quyền hoặc quyền sử dụng thương mại.

Từ chối các đầu vào không được hỗ trợ sớm và yêu cầu xem xét của con người bất cứ khi nào vùng sửa chữa giao với chi tiết chuyển động quan trọng.

Thanh toán, lỗi và chính sách thử lại

Việc xóa phụ đề video được tính phí theo thời lượng và độ phân giải. Bảng giá hiện tại là 1.3 tín dụng mỗi giây ở 720p trở xuống và 1.6 tín dụng mỗi giây trên 720p lên đến 1080p. Do đó, video 30 giây 1280×720 là khoảng 39 tín dụng, trong khi video 30 giây 1920×1080 là khoảng 48 tín dụng. Truy vấn /open/queryCredits trước khi chấp nhận một lô lớn.

Ước tính chi phí trước khi gửi

Các phản hồi thành công bao gồm code và message; phản hồi tác vụ còn hiển thị thêm status và khi hoàn thành, resultUrl. Các tác vụ thất bại có thể bao gồm failCode, failReason và refundStatus. Thử lại các lỗi vận chuyển hoặc lỗi nội bộ tạm thời với backoff theo cấp số nhân, nhưng không thử lại mù quáng các tham số không hợp lệ, phương tiện không được hỗ trợ, tài khoản bị đình chỉ hoặc lỗi tín dụng không đủ.

Xử lý các trường lỗi ổn định

Ghi lại độ trễ gửi, độ trễ hoàn thành, tỷ lệ thất bại, tỷ lệ từ chối xem xét và chi phí cho mỗi tài sản được phê duyệt. Các chỉ số này cho thấy liệu tự động hóa có đang cải thiện quy trình làm việc hay chỉ đang chuyển công việc thủ công xuống phía dưới.

Một tích hợp hữu ích đo lường đầu ra được phê duyệt và chi phí hiệu quả, không chỉ các phản hồi HTTP thành công.

Khởi chạy tích hợp trong bốn bước

Đầu tiên, tạo khóa API từ trang nhà phát triển 550W được bản địa hóa và gửi một video đại diện. Thứ hai, triển khai tra cứu tác vụ và hiển thị trạng thái chờ, đang xử lý, thành công và thất bại trong sản phẩm của riêng bạn. Thứ ba, thêm tính idempotency và webhook với khôi phục polling. Cuối cùng, chạy một lô được kiểm soát và xem lại mọi đầu ra trước khi tăng tính đồng thời.

Thử nghiệm trước khi mở rộng quy mô

Sử dụng các điều khiển phát triển và sản xuất riêng biệt, xoay thông tin xác thực bị lộ, hạn chế quyền truy cập vào phương tiện nguồn và duy trì chính sách xóa kết quả. Các nhóm có tiêu chí chấp nhận rõ ràng sau đó có thể kết nối API với DAM, CMS, hàng đợi bản địa hóa hoặc quy trình tải lên của nhà sáng tạo mà không phải hy sinh việc xem xét biên tập.