API Video Eraser untuk subtitle dan watermark video serta gambar

Cakupan nyata API pengembang 550W

API pengembang 550W memungkinkan server mengirim tugas berizin untuk memproses subtitle atau watermark yang terlihat di dalam persegi pilihan, serta watermark gambar. Akses API tidak memberikan hak atas materi sumber; hasil tetap harus diperiksa.

Pemrosesan subtitle dan watermark video

Untuk video MP4 atau MOV, unggah melalui /open/uploadVideo atau berikan videoUrl HTTPS yang dapat diakses melalui /open/submitTask. Permintaan memuat lebar, tinggi, durasi, dan koordinat area yang akan diolah. Tugas berjalan asinkron; periksa statusnya lewat /open/taskDetail atau /open/taskList.

Menghapus watermark gambar

/open/removeImageWatermark menerima JPG, PNG, BMP, WebP, AVIF, TIFF, dan SVG hingga 50 MB per gambar. API bisa mengembalikan hasil atau tugas yang diperiksa kemudian. API ini tidak menyediakan pengunduhan video dari tautan untuk menghapus watermark; jangan menjanjikan fungsi tersebut.

Gunakan API untuk teks video dan watermark gambar yang berizin, sesuai cakupan layanan yang benar.

Susun permintaan yang aman untuk produksi

Setiap permintaan menggunakan userNo dan apiKey. Simpan keduanya di server, bukan di kode browser atau aplikasi seluler yang dapat dilihat pengguna. Video dapat diunggah lebih dahulu atau diberikan melalui URL HTTP(S) publik.

Simpan identitas dan sumber pada server

Kirim width, height, duration, serta x1, y1, x2, y2 ke /open/submitTask. Standard (mode=normal, default) mengolah bagian di dalam kotak pilihan. Protect (mode=protect) mempertahankan bagian dalam dan mengolah bagian luar; bukan mode kualitas lebih tinggi. Gunakan removeAudio hanya jika suara memang harus dihapus sebelum pengolahan.

Kirim tugas dengan kunci idempoten

Sertakan Idempotency-Key maksimal 128 karakter saat membuat tugas. Jika sambungan terputus setelah pengiriman, ulangi dengan kunci yang sama untuk pekerjaan yang sama agar tidak membuat tugas berbayar ganda. Simpan taskId bersama ID aset internal.

Konfirmasi hasil setelah tugas berakhir

Untuk pemberitahuan asinkron, sediakan callbackUrl HTTP(S) publik. Balas webhook dengan cepat lalu cek ulang status lewat /open/taskDetail. Siapkan handler untuk notifikasi berulang dan tetap gunakan polling jika pemberitahuan tertunda.

Kredensial server, kunci idempoten, ID tugas yang tersimpan, dan pengecekan ulang membuat alur lebih aman.

Periksa batas input dan mutu hasil

Batas video di API berbeda dari alur unggah browser. Periksa ketentuan API yang berlaku, lalu validasi format, durasi, resolusi, kedalaman bit, dan HDR sebelum mengirim berkas agar media yang tidak didukung tidak masuk antrean pemrosesan.

Validasi sebelum memakai kredit

Hasil dipengaruhi gerakan di balik subtitle atau teks. Dinding polos dan langit umumnya lebih mudah dinilai dibanding tangan, rambut, kain bermotif, pantulan, atau gerakan kamera cepat. Buat antrean pemeriksaan untuk kasus sulit dan tonton seluruh video hasil, bukan hanya gambar mini.

Tinjau area dengan gerakan rumit

Tugas gambar dikenai kredit berdasarkan ketentuan pada halaman API yang berlaku setelah berhasil diproses. Simpan gambar sumber dan hasil sebagai berkas terpisah. Menghapus watermark tidak memberi izin hak cipta atau penggunaan komersial.

Tolak input yang tidak didukung lebih awal dan periksa secara visual area yang menutupi detail bergerak.

Hitung biaya dan bedakan jenis kegagalan

Biaya penghapusan subtitle video bergantung pada durasi dan resolusi. Halaman API saat ini mencantumkan 1,3 kredit per detik hingga 720p dan 1,6 kredit per detik di atas 720p hingga 1080p. Video 30 detik masing-masing sekitar 39 atau 48 kredit. Periksa /open/queryCredits dan syarat harga terkini sebelum mengirim banyak tugas.

Perkirakan biaya sebelum mengirim

Respons memuat code dan message; respons tugas juga menampilkan status serta resultUrl setelah selesai. Pada kegagalan, periksa failCode, failReason, dan refundStatus jika tersedia. Gangguan jaringan sementara dapat dicoba lagi dengan jeda yang meningkat, tetapi parameter salah, media tidak didukung, akun ditangguhkan, atau kredit kurang memerlukan tindakan lain.

Gunakan kode kegagalan untuk menentukan retry

Catat waktu pengiriman hingga penyelesaian, tingkat kegagalan, penolakan saat pemeriksaan, dan biaya per aset yang disetujui. Angka tersebut lebih berguna daripada sekadar jumlah respons HTTP yang berhasil.

Nilai biaya dan hasil yang disetujui, bukan hanya keberhasilan permintaan teknis.

Mulai dari uji kecil sebelum meningkatkan skala

Buat kunci API di halaman pengembang 550W dan kirim satu video yang mewakili materi nyata. Implementasikan pencarian tugas beserta status menunggu, diproses, berhasil, dan gagal. Tambahkan kunci idempoten, webhook, serta polling cadangan. Periksa semua hasil dari kelompok kecil sebelum menambah tugas bersamaan.

Coba alur lengkap terlebih dahulu

Pisahkan kontrol pengembangan dan produksi, ganti kredensial yang bocor, batasi akses ke media sumber, dan tetapkan kebijakan penghapusan hasil. Hubungkan API ke DAM, CMS, atau alur lokalisasi hanya dengan kriteria penerimaan dan persetujuan editorial yang jelas.