API 550W untuk Penyingkiran Subtitle dan Tera Air Imej
Apa yang sebenarnya disokong oleh API pembangun 550W
API pembangun 550W membolehkan backend menghantar kerja penyingkiran subtitle atau teks video dan kerja penyingkiran tera air imej tanpa menghantar pengguna melalui editor manual. Ia direka untuk platform kandungan, saluran tempatan, pustaka media, dan alat dalaman yang memproses kandungan milik organisasi atau mempunyai lesen untuk diedit secara berulang.
Penyingkiran subtitle dan teks video
Untuk video, hantar rakaman MP4 atau MOV melalui /open/uploadVideo atau berikan videoUrl awam kepada /open/submitTask. Permintaan termasuk dimensi video, tempoh, dan segiempat tepat untuk dibaiki. Kerja video dijalankan secara tidak segerak dan boleh diperiksa melalui /open/taskDetail atau /open/taskList.
Penyingkiran tera air imej
Untuk imej, /open/removeImageWatermark menerima fail JPG, PNG, BMP, WebP, AVIF, TIFF, atau SVG sehingga 50 MB. Ia boleh menunggu keputusan atau mengembalikan tugas pemprosesan untuk carian kemudian. API pembangun Eraser tidak mendedahkan muat turun tera air daripada pove/link video, jadi integrasi tidak boleh menjanjikan keupayaan itu.
Gunakan API untuk pembersihan subtitle/teks video yang dibenarkan dan penyingkiran tera air imej; jangan masukkan kerja tera air pove/link video yang tidak disokong dalam janji produk anda.
Aliran permintaan yang sedia untuk pengeluaran
Setiap permintaan disahkan dengan userNo dan apiKey. Simpan kedua-dua nilai di pelayan anda: meletakkan kunci API dalam kod klien penyemak imbas atau mudah alih menjadikannya boleh dipulihkan oleh pengguna dan sambungan. Video boleh dimuat naik terlebih dahulu atau dibekalkan sebagai URL HTTPS yang boleh dicapai secara awam.
| Tahap | Titik akhir | Simpan dalam sistem anda |
|---|---|---|
| Muat naik | /open/uploadVideo | videoUrl, coverUrl, dimensi, tempoh |
| Serah | /open/submitTask | taskId, kunci idempotensi, ID aset |
| Pantau | /open/taskDetail atau /open/taskList | status, kos, kegagalan dan medan bayaran balik |
| Hantar | callbackUrl dan resultUrl | terbitan yang diluluskan dan peristiwa audit |
Pengesahan dan muat naik
Hantar /open/submitTask dengan width, height, duration, dan x1, y1, x2, y2. Segiempat tepat yang ketat biasanya memelihara lebih banyak butiran daripada pembaikan skrin penuh. Gunakan mode=protect apabila aliran kerja yang disokong memerlukan pembinaan konservatif, dan gunakan removeAudio hanya apabila audio perlu dikeluarkan sebelum pemprosesan.
Hantar kerja idempoten
Hantar Idempotency-Key tidak lebih daripada 128 aksara untuk pembuatan yang selamat untuk dicuba semula. Jika sambungan terputus selepas penyerahan, cuba lagi dengan kunci yang sama sebaliknya membuat kerja kedua yang boleh dicaj. Simpan taskId yang dikembalikan di sebelah ID aset anda sendiri.
Terima dan sahkan keputusan
Untuk penghantaran tidak segerak, berikan callbackUrl HTTPS awam. Webhook diaktifkan apabila tugas mencapai keadaan akhir. Pengendali anda harus mengakui dengan cepat, sahkan tugas tersebut sekali lagi melalui /open/taskDetail, dan layan penghantaran webhook yang berulang sebagai normal. Undian kekal berguna sebagai laluan pemulihan apabila panggilan balik ditangguhkan.
Kredensial sisi pelayan, idempotensi, ID tugas yang tahan lasak, dan pengesahan webhook menjadikan percubaan semula selamat dan boleh diperhatikan.
Had input dan kawalan kualiti
Video yang dimuat naik menyokong MP4 dan MOV, saiz fail maksimum 1 GB, tempoh sehingga 600 saat, dan pemprosesan sehingga 1080p mengikut peraturan dimensi yang didokumenkan. Sahkan format, tempoh, dimensi, kedalaman bit, dan status HDR sebelum menyerahkan supaya media yang tidak disokong tidak pernah memasuki giliran berbayar.
Sahkan sebelum membeli kredit
Kualiti bergantung pada apa yang bergerak di belakang subtitle atau teks. Dinding rata, langit, dan landskap yang berubah perlahan biasanya lebih mudah daripada tangan, rambut, pakaian bercorak, pantulan, atau pergerakan kamera yang cepat. Bina giliran semakan untuk kes tepi dan bandingkan seluruh garis masa, bukan hanya thumbnail sahaja.
Semak rakaman yang sukar
Kerja imej menyokong format web dan reka bentuk biasa dan berharga jumlah kredit tetap setiap tugas yang berjaya mengikut halaman API semasa. Preserve fail sumber dan simpan keputusan sebagai terbitan; penyingkiran tera air tidak mewujudkan kebenaran hak cipta atau penggunaan komersial.
Tolak input yang tidak disokong lebih awal dan memerlukan semakan manusia apabila kawasan pembaikan merentasi perincian bergerak penting.
Bil, kegagalan, dan dasar percubaan semula
Penyingkiran subtitle video dicaj mengikut tempoh dan resolusi. Jadual semasa ialah 1.3 kredit setiap saat pada 720p atau ke bawah dan 1.6 kredit setiap saat melebihi 720p sehingga 1080p. Video 30 saat 1280×720 ialah kira-kira 39 kredit, sementara video 30 saat 1920×1080 ialah kira-kira 48 kredit. Jalankan /open/queryCredits sebelum menerima kumpulan besar.
Anggarkan kos sebelum diserahkan
Respons yang berjaya termasuk code dan message; respons tugas juga mendedahkan status dan, apabila lengkap, resultUrl. Tugas yang gagal boleh termasuk failCode, failReason, dan refundStatus. Cuba semula kegagalan pengangkutan sementara atau dalaman dengan lengkung belakang eksponen, tetapi jangan cuba lagi butiran palsu, media yang tidak disokong, akaun digantung, atau ralat kredit yang tidak mencukupi secara membuta tuli.
Kendali medan kegagalan yang stabil
Rekod kependaman penyerahan, kependaman selesai, kadar kegagalan, kadar penolakan semakan, dan kos setiap aset yang diluluskan. Metrik ini mendedahkan sama ada automasi meningkatkan aliran kerja dan bukan sekadar memindahkan kerja manual ke hilir.
Integrasi yang berguna mengukur output yang diluluskan dan kos berkesan, bukan hanya respons HTTP yang berjaya.
Lancarkan integrasi dalam empat langkah
Pertama, hasilkan kunci API daripada halaman pembangun 550W yang dilokalisasikan dan hantar satu video perwakilan. Kedua, laksanakan carian tugas dan paparkan keadaan menunggu, pemprosesan, kejayaan, dan gagal dalam produk anda sendiri. Ketiga, tambahkan idempotensi dan webhook dengan pemulihan undian. Akhir sekali, jalankan kumpulan terkawal dan semak setiap output sebelum meningkatkan kesebandingan.
Perintis sebelum penskalaan
Gunakan kawalan pembangunan dan pengeluaran yang berasingan, putarkan kredensial yang terdedah, hadkan akses kepada media sumber, dan pastikan dasar penghapusan untuk keputusan. Pasukan dengan kriteria penerimaan yang jelas boleh kemudian menyambungkan API kepada DAM, CMS, giliran tempatan, atau aliran kerja muat naik pencipta tanpa mengorbankan semakan editorial.
Soalan Lazim
Kerja video mana yang boleh saya serahkan melalui API?
API pembangun Eraser menerima kerja penyingkiran subtitle atau teks video yang dibenarkan menggunakan fail MP4/MOV yang dimuat naik atau URL video awam. Ia tidak mendedahkan muat turun tera air pove/link video.
Patutkah saya mengundi atau menggunakan webhook?
Gunakan webhook untuk selesai normal dan kekalkan undian butiran tugas sebagai laluan pemulihan. Jadikan kedua-dua pengendali idempoten kerana penghantaran atau percubaan semula mungkin berlaku lebih daripada sekali.
Bagaimana saya boleh mengelakkan caj berganda selepas masa tamat?
Hantar Idempotency-Key yang stabil dengan penyerahan tugas dan gunakan semula nilai yang sama apabila mencuba semula kerja logik yang sama.
Bagaimana kerja video dicaj?
Halaman API semasa menyenaraikan 1.3 kredit setiap saat pada 720p atau ke bawah dan 1.6 kredit setiap saat melebihi 720p sehingga 1080p. Semak halaman pembangun untuk terma semasa sebelum mengekodkan anggaran secara kekal.
Bolehkah saya mendedahkan kunci API dalam kod hadapan?
Tidak. Simpan userNo dan apiKey di backend anda dan proksi permintaan yang dibenarkan melalui pelayan anda sendiri.