API Video Eraser xử lý phụ đề và hình mờ trong video, hình ảnh

Các tác vụ API nhà phát triển thực sự hỗ trợ

API nhà phát triển 550W cho phép máy chủ gửi tác vụ có quyền xử lý phụ đề/chữ hoặc hình mờ nhìn thấy trong một hình chữ nhật đã chọn, cùng tác vụ xử lý hình mờ trên ảnh. Quyền truy cập API không cấp quyền đối với tư liệu nguồn và kết quả vẫn cần được kiểm tra.

Xử lý phụ đề và hình mờ trong video

Với video MP4 hoặc MOV, tải tệp lên qua /open/uploadVideo hoặc cung cấp videoUrl HTTPS có thể truy cập công khai cho /open/submitTask. Yêu cầu gồm chiều rộng, chiều cao, thời lượng và tọa độ vùng cần xử lý. Tác vụ chạy không đồng bộ; dùng /open/taskDetail hoặc /open/taskList để xem trạng thái.

Xóa hình mờ trên ảnh

/open/removeImageWatermark nhận JPG, PNG, BMP, WebP, AVIF, TIFF và SVG, hiện tối đa 50 MB cho mỗi ảnh. API có thể trả kết quả ngay hoặc tạo tác vụ để tra cứu sau. API này không cung cấp tính năng tải video từ liên kết để bỏ hình mờ, nên đừng hứa hẹn khả năng đó.

Chỉ tích hợp việc xử lý chữ video và hình mờ ảnh theo đúng quyền sử dụng cùng phạm vi API.

Thiết kế luồng yêu cầu an toàn

Mỗi yêu cầu dùng userNo và apiKey. Hãy giữ cả hai ở máy chủ của bạn, không nhúng khóa vào mã trình duyệt hoặc ứng dụng di động. Video có thể được tải lên trước hoặc cung cấp bằng URL HTTP(S) công khai.

Giữ thông tin xác thực ở máy chủ

Gửi width, height, duration cùng x1, y1, x2, y2 tới /open/submitTask. Standard (mode=normal, mặc định) xử lý phần bên trong vùng chọn. Protect (mode=protect) giữ nguyên phần bên trong và xử lý phần bên ngoài; đây không phải chế độ tăng chất lượng. Chỉ đặt removeAudio khi cần bỏ âm thanh trước khi xử lý.

Gửi tác vụ kèm khóa chống trùng

Khi tạo tác vụ, gửi Idempotency-Key dài tối đa 128 ký tự. Nếu kết nối đứt sau khi gửi, hãy dùng lại cùng khóa cho đúng tác vụ đó để tránh tạo một tác vụ có thể tính phí lần nữa. Lưu taskId bên cạnh mã tài sản nội bộ.

Kiểm tra lại trạng thái trước khi nhận kết quả

Để nhận thông báo, cung cấp callbackUrl HTTP(S) công khai. Hãy phản hồi webhook nhanh, rồi tra lại /open/taskDetail để xác nhận trạng thái. Cần xử lý được thông báo lặp và duy trì cách hỏi trạng thái định kỳ nếu thông báo bị chậm.

Thông tin xác thực phía máy chủ, khóa chống trùng, mã tác vụ đã lưu và bước xác nhận lại giúp việc thử lại an toàn.

Kiểm tra giới hạn đầu vào và chất lượng

Điều kiện đầu vào video của API khác với luồng tải lên trong trình duyệt. Kiểm tra tài liệu API hiện hành, sau đó xác thực định dạng, thời lượng, độ phân giải, độ sâu bit và HDR trước khi gửi để tránh đưa tệp không được hỗ trợ vào hàng xử lý.

Xác thực trước khi tiêu thụ tín dụng

Kết quả phụ thuộc chuyển động đằng sau phụ đề hoặc chữ. Tường trơn và bầu trời thường dễ đánh giá hơn bàn tay, tóc, áo có hoa văn, hình phản chiếu hoặc máy quay di chuyển nhanh. Tạo hàng chờ kiểm tra cho trường hợp khó và xem cả video xuất ra, không chỉ ảnh thu nhỏ.

Xem kỹ những cảnh có chuyển động phức tạp

Chi phí xử lý ảnh thành công theo điều kiện hiện có trên trang API. Giữ tệp gốc và lưu kết quả thành bản riêng. Khả năng xóa hình mờ không tạo ra quyền tác giả hoặc quyền khai thác thương mại.

Loại đầu vào không phù hợp từ sớm và yêu cầu con người xem lại vùng xử lý chồng lên chi tiết chuyển động.

Tính chi phí và xử lý từng loại lỗi

Chi phí xóa phụ đề video phụ thuộc thời lượng và độ phân giải. Trang API hiện nêu 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 đến 1080p. Video 30 giây tương ứng khoảng 39 hoặc 48 tín dụng. Kiểm tra /open/queryCredits và giá hiện hành trước khi gửi một nhóm lớn.

Ước lượng chi phí trước khi gửi

Ghi code và message trong phản hồi, cùng status và resultUrl khi tác vụ hoàn tất. Khi thất bại, kiểm tra failCode, failReason và refundStatus nếu có. Có thể thử lại lỗi truyền dữ liệu tạm thời với khoảng chờ tăng dần, nhưng tham số sai, định dạng không hỗ trợ, tài khoản bị ngừng hoặc thiếu tín dụng cần cách xử lý khác.

Dựa vào mã lỗi để quyết định thử lại

Ghi thời gian từ lúc gửi đến khi xong, tỷ lệ lỗi, tỷ lệ bị từ chối trong khâu xem lại và chi phí cho mỗi tệp đã được duyệt. Chỉ đếm phản hồi HTTP thành công không cho biết công việc thủ công phía sau có tăng không.

Đánh giá tệp được duyệt và chi phí thực tế, thay vì chỉ dựa vào phản hồi kỹ thuật thành công.

Thử luồng nhỏ trước khi mở rộng

Tạo khóa API trên trang nhà phát triển 550W và gửi một video đại diện. Hiển thị các trạng thái chờ, đang xử lý, thành công và thất bại trong sản phẩm của bạn. Sau đó thêm khóa chống trùng, webhook và phương án hỏi trạng thái dự phòng. Xem lại mọi kết quả của nhóm nhỏ trước khi tăng số tác vụ đồng thời.

Kiểm tra từ đầu đến cuối rồi mới tăng số tác vụ

Tách cách quản lý môi trường phát triển và sản xuất, thay thông tin xác thực bị lộ, hạn chế quyền truy cập tư liệu gốc và đặt chính sách xóa kết quả. Khi nối API với DAM, CMS hoặc quy trình bản địa hóa, vẫn cần tiêu chí chấp nhận và phê duyệt biên tập.