550W API untuk Penghapusan Subtitle dan Watermark Gambar

Dukungan Aktual API Pengembang 550W

API pengembang 550W memungkinkan backend mengajukan pekerjaan penghapusan subtitle atau teks video dan pekerjaan penghapusan watermark gambar tanpa mengarahkan pengguna ke editor manual. API ini dirancang untuk platform kreator, alur kerja lokalisasi, pustaka media, dan alat internal yang berulang kali memproses konten yang dimiliki organisasi atau dilisensikan untuk diedit.

Penghapusan subtitle dan teks video

Untuk video, kirim file video MP4 atau MOV melalui /open/uploadVideo atau berikan videoUrl publik ke /open/submitTask. Permintaan mencakup dimensi video, durasi, dan persegi panjang yang akan diperbaiki. Pekerjaan video berjalan secara asinkron dan dapat diperiksa melalui /open/taskDetail atau /open/taskList.

Penghapusan watermark gambar

Untuk gambar, /open/removeImageWatermark menerima file JPG, PNG, BMP, WebP, AVIF, TIFF, atau SVG hingga 50 MB. API ini dapat menunggu hasil atau mengembalikan tugas pemrosesan untuk pencarian selanjutnya. API pengembang Eraser tidak menyediakan unduhan watermark tautan video, jadi integrasi tidak boleh menjanjikan kemampuan tersebut.

Gunakan API untuk pembersihan subtitle/teks video yang diotorisasi dan penghapusan watermark gambar; singkirkan alur kerja watermark tautan video yang tidak didukung dari janji produk Anda.

Alur Permintaan Siap Produksi

Setiap permintaan diautentikasi dengan userNo dan apiKey. Simpan kedua nilai di server Anda: menempatkan kunci API di kode browser atau klien seluler membuatnya dapat dipulihkan oleh pengguna dan ekstensi. Video dapat diunggah terlebih dahulu atau disediakan sebagai URL HTTPS yang dapat dijangkau publik.

Autentikasi dan upload

Kirim /open/submitTask dengan width, height, duration, dan x1, y1, x2, y2. Persegi panjang yang ketat biasanya mempertahankan lebih banyak detail daripada perbaikan seluruh layar. Gunakan mode=protect ketika alur kerja yang didukung memerlukan rekonstruksi konservatif, dan gunakan removeAudio hanya ketika audio harus dihapus sebelum pemrosesan.

Kirim tugas idempoten

Kirim Idempotency-Key dengan maksimal 128 karakter untuk pembuatan yang aman dari percobaan ulang. Jika koneksi terputus setelah pengiriman, coba lagi dengan kunci yang sama alih-alih membuat pekerjaan kedua yang dapat ditagih. Simpan taskId yang dikembalikan di samping ID aset Anda sendiri.

Terima dan verifikasi hasil

Untuk pengiriman asinkron, berikan callbackUrl HTTPS publik. Webhook dipicu ketika tugas mencapai status akhir. Handler Anda harus mengakui dengan cepat, verifikasi tugas lagi melalui /open/taskDetail, dan perlakukan pengiriman webhook berulang sebagai normal. Polling tetap berguna sebagai jalur pemulihan ketika callback tertunda.

Kredensial sisi server, idempotency, ID tugas yang tahan lama, dan verifikasi webhook membuat percobaan ulang aman dan dapat diamati.

Batasan Input dan Kontrol Kualitas

Video yang diunggah mendukung MP4 dan MOV, ukuran file maksimal 1 GB, durasi hingga 600 detik, dan pemrosesan hingga 1080p dalam aturan dimensi yang didokumentasikan. Validasi format, durasi, dimensi, bit depth, dan status HDR sebelum pengiriman agar media yang tidak didukung tidak pernah masuk ke antrean berbayar.

Validasi sebelum menghabiskan kredit

Kualitas tergantung pada apa yang bergerak di balik subtitle atau teks. Dinding datar, langit, dan pemandangan yang berubah perlahan biasanya lebih mudah daripada tangan, rambut, pakaian bermotif, pantulan, atau gerakan kamera yang cepat. Bangun antrean ulasan untuk kasus tepi dan bandingkan seluruh timeline, bukan hanya thumbnail.

Tinjau rekaman yang sulit

Pekerjaan gambar mendukung format web dan desain umum serta dikenakan jumlah kredit tetap per tugas yang berhasil sesuai halaman API saat ini. Pertahankan file sumber dan simpan hasil sebagai turunan; penghapusan watermark tidak menciptakan hak cipta atau izin penggunaan komersial.

Tolak input yang tidak didukung lebih awal dan wajibkan tinjauan manusia kapan pun area perbaikan melintasi detail bergerak yang penting.

Penagihan, Kegagalan, dan Kebijakan Coba Ulang

Penghapusan subtitle video ditagih berdasarkan durasi dan resolusi. Jadwal saat ini adalah 1,3 kredit per detik pada 720p atau lebih rendah dan 1,6 kredit per detik di atas 720p hingga 1080p. Video 30 detik 1280×720 therefore adalah sekitar 39 kredit, sedangkan video 30 detik 1920×1080 adalah sekitar 48 kredit. Kueri /open/queryCredits sebelum menerima kumpulan besar.

Perkirakan biaya sebelum pengiriman

Respons sukses menyertakan code dan message; respons tugas additionally mengekspos status dan, ketika selesai, resultUrl. Tugas yang gagal dapat menyertakan failCode, failReason, dan refundStatus. Coba ulang kegagalan transportasi atau internal sementara dengan backoff eksponensial, tetapi jangan coba ulang secara buta parameter tidak valid, media tidak didukung, akun yang ditangguhkan, atau kesalahan kredit tidak cukup.

Tangani kolom kegagalan stabil

Catat latensi pengiriman, latensi penyelesaian, tingkat kegagalan, tingkat penolakan ulasan, dan biaya per aset yang disetujui. Metrik ini mengungkapkan apakah otomatisasi meningkatkan alur kerja alih-alih hanya memindahkan pekerjaan manual ke hilir.

Integrasi yang berguna mengukur output yang disetujui dan biaya efektif, bukan hanya respons HTTP yang berhasil.

Luncurkan Integrasi dalam Empat Langkah

Pertama, hasilkan kunci API dari halaman pengembang 550W yang dilokalkan dan kirimkan satu video representatif. Kedua, implementasikan pencarian tugas dan tampilkan status menunggu, sedang diproses, berhasil, dan gagal di produk Anda sendiri. Ketiga, tambahkan idempotency dan webhook dengan pemulihan polling. Terakhir, jalankan kumpulan terkontrol dan tinjau setiap output sebelum meningkatkan konkurensi.

Pilot sebelum penskalaan

Gunakan kontrol pengembangan dan produksi terpisah, rotasi kredensial yang terekspos, batasi akses ke media sumber, dan pertahankan kebijakan penghapusan untuk hasil. Tim dengan kriteria penerimaan yang jelas dapat menghubungkan API ke DAM, CMS, antrean lokalisasi, atau alur kerja upload kreator tanpa mengorbankan tinjauan editorial.