Alt Yazı ve Görsel Filigran Kaldırma için Video Eraser API
550W geliştirici API'si aslında ne destekliyor
550W geliştirici API'si, bir arka uç sunucunun kullanıcıları manuel bir düzenleyiciye göndermeden video alt yazı veya metin silme işleri ile görsel filigran kaldırma işlerini göndermesine olanak tanır. Tekrarlayan şekilde işledikleri içerik üzerinde mülkiyet hakkına veya düzenleme lisansına sahip oldukları yaratıcı platformlar, yerelleştirme boru hatları, medya kitaplıkları ve dahili araçlar için tasarlanmıştır.
Video alt yazı ve metin silme
Videolar için, /open/uploadVideo üzerinden MP4 veya MOV görüntüleme dosyası yükleyin veya /open/submitTask'a genel bir videoUrl sağlayın. İstek, video boyutlarını, süresini ve onarılacak dikdörtgen alanı içerir. Video işleri eşzamansız çalışır ve /open/taskDetail veya /open/taskList üzerinden kontrol edilebilir.
Görsel filigran kaldırma
Görseller için, /open/removeImageWatermark 50 MB'a kadar JPG, PNG, BMP, WebP, AVIF, TIFF veya SVG dosyalarını kabul eder. Sonuç için bekleyebilir veya daha sonra arama için bir işleme görevi döndürebilir. Eraser geliştirici API'si video bağlantı filigranı indirmeyi kullanıma sunmaz, bu nedenle entegrasyonlar bu özelliği vaat etmemelidir.
İzin verilen video alt yazı/metın temizleme ve görsel filigran kaldırma için API'yi kullanın; desteklenmeyen video bağlantı filigran iş akışlarını ürün vaadinizden çıkarın.
Üretim kullanımına hazır bir istek akışı
Her istek userNo ve apiKey ile kimlik doğrulaması yapılır. Her iki değeri de sunucunuzda saklayın: Bir API anahtarını tarayıcı veya mobil istemci koduna yerleştirmek, kullanıcıların ve eklentilerin bunu almasını kurtarılabilir kılar. Bir video önce yüklenebilir veya genel erişilebilir bir HTTPS URL'si olarak sağlanabilir.
| Aşama | Uç Nokta | Sisteminizde Saklayın |
|---|---|---|
| Yükleme | /open/uploadVideo | videoUrl, coverUrl, boyutlar, süre |
| Gönderme | /open/submitTask | taskId, değişmez anahtar, varlık kimliği |
| İzleme | /open/taskDetail veya /open/taskList | durum, maliyet, başarısızlık ve iade alanları |
| Teslimat | callbackUrl ve resultUrl | onaylanmış türev ve denetim olayı |
Kimlik doğrulama ve yükleme
Genişlik, yükseklik, süre ve x1, y1, x2, y2 ile /open/submitTask gönderin. Sıkı bir dikdörtgen genellikle tam ekran onarımdan daha fazla detay korur. Desteklenen iş akışı muhafazakar yeniden yapılandırma gerektirdiğinde mode=protect kullanın ve sesin işlenmeden önce çıkarılması gerektiğinde yalnızca removeAudio kullanın.
Değişmez bir iş gönderme
Yeniden deneme güvenli oluşturma için en fazla 128 karakterlik bir Idempotency-Key gönderin. Gönderimden sonra bağlantı kesilirse, ikinci bir faturalanabilir iş oluşturmak yerine aynı anahtarla yeniden deneyin. Döndürülen taskId'yi kendi varlık kimliğinizin yanında saklayın.
Sonucu alma ve doğrulama
Eşzamansız teslimat için genel bir HTTPS callbackUrl sağlayın. Görev son duruma ulaştığında webhook tetiklenir. İşleyiciniz hızlı bir şekilde onaylamalı, görevi /open/taskDetail üzerinden tekrar doğrulamalı ve tekrarlanan webhook teslimatını normal olarak değerlendirmelidir. Bir geri arama geciktiğinde yoklama, kurtarma yolu olarak kullanışlı kalır.
Sunucu tarafı kimlik bilgileri, değişmez anahtarlar, kalıcı görev kimlikleri ve webhook doğrulaması yeniden denemeleri güvenli ve izlenebilir kılar.
Giriş limitleri ve kalite kontrolleri
Yüklenen videolar, en fazla 1 GB dosya boyutu, 600 saniyeye kadar süre ve belgelenen boyut kuralları dahilinde 1080p'ye kadar işleme ile MP4 ve MOV destekler. Desteklenmeyen ortamın ücretli kuyruğa girmemesi için göndermeden önce formatı, süreyi, boyutları, bit derinliğini ve HDR durumunu doğrulayın.
Kredi harcayamadan önce doğrulayın
Kalite, alt yazının veya metnin arkasında neyin hareket ettiğine bağlıdır. Düz duvarlar, gökyüzü ve yavaş değişen manzaralar genellikle eller, saç, desenli kıyafetler, yansımalar veya hızlı kamera hareketinden daha kolaydır. Sınır durumları için bir inceleme kuyruğu oluşturun ve yalnızca bir küçük resme değil, tüm zaman çizelgesini karşılaştırın.
Zorlu görüntüleri inceleyin
Görsel işler yaygın web ve tasarım formatlarını destekler ve geçerli API sayfasına göre başarılı her görev için sabit sayıda kredi maliyetindedir. Kaynak dosyayı koruyun ve sonucu bir türev olarak kaydedin; filigran kaldırma telif hakkı veya ticari kullanım izni oluşturmaz.
Desteklenmeyen girişleri erken aşamada reddedin ve onarım alanı önemli hareketli ayrıntıları kestiğinde insan incelemesi gerektirin.
Faturalandırma, başarısızlıklar ve yeniden deneme politikası
Video alt yazı kaldırma işlemi süre ve çözünürlüğe göre faturalandırılır. Mevcut tarife, 720p ve altı için saniyede 1,3 kredi ve 720p üzerinden 1080p'ye kadar saniyede 1,6 kredidir. Bu nedenle, 30 saniyelik 1280×720 video yaklaşık 39 kredi, 30 saniyelik 1920×1080 video ise yaklaşık 48 kredidir. Büyük bir toplu işlemi kabul etmeden önce /open/queryCredits sorgulayın.
Göndermeden önce maliyeti tahmin edin
Başarılı yanıtlar code ve message içerir; görev yanıtları ayrıca durumu ve tamamlandığında resultUrl'yi gösterir. Başarısız görevler failCode, failReason ve refundStatus içerebilir. Geçici transport veya dahili hataları üstel geri çekilme ile yeniden deneyin, ancak geçersiz parametreleri, desteklenmeyen ortamları, askıya alınmış hesapları veya yetersiz kredi hatalarını körü körüne yeniden denemeyin.
Kararlı başarısızlık alanlarını işleyin
Gönderim gecikmesini, tamamlanma gecikmesini, başarısızlık oranını, inceleme reddetme oranını ve onaylanan varlık başına maliyeti kaydedin. Bu metrikler, otomasyonun yalnızca manuel işi aşağı taşıyıp taşımadığını değil, iş akışını gerçekten iyileştirip iyileştirmediğini ortaya koyar.
Yararlı bir entegrasyon, yalnızca başarılı HTTP yanıtlarını değil, onaylanan çıktıyı ve etkin maliyeti ölçer.
Entegrasyonu dört adımda başlatın
Önce, yerelleştirilmiş 550W geliştirici sayfasından bir API anahtarı oluşturun ve temsili bir video gönderin. İkinci olarak, görev aramayı uygulayın ve kendi ürününüzde bekliyor, işleniyor, başarılı ve başarısız durumları görüntüleyin. Üçüncü olarak, yoklama kurtarması ile bir webhook ve değişmez anahtar ekleyin. Son olarak, kontrollü bir toplu işlem çalıştırın ve eşzamanlılığı artırmadan önce her çıktıyı inceleyin.
Ölçeklenmeden önce pilot uygulama yapın
Ayrı geliştirme ve üretim kontrolleri kullanın, ortaya çıkan kimlik bilgilerini döndürün, kaynak ortama erişimi kısıtlayın ve sonuçlar için bir silme politikası tutun. Net kabul kriterleri olan ekipler, editöryel incelemeden ödün vermeden API'yi bir DAM, CMS, yerelleştirme kuyruğu veya yaratıcı yükleme iş akışına bağlayabilir.
Sıkça Sorulan Sorular
API üzerinden hangi video işlerini gönderebilirim?
Eraser geliştirici API'si, yüklenen bir MP4/MOV dosyası veya genel bir video URL'si kullanarak yetkilendirilmiş video alt yazı veya metin silme işlerini kabul eder. Video bağlantı filigranı indirmeyi kullanıma sunmaz.
Yoklamalı mı yoksa webhook mu kullanmalıyım?
Normal tamamlanma için webhook kullanın ve görev ayrıntı yoklamasını bir kurtarma yolu olarak saklayın. Her iki işleyiciyi de değişmez yapın çünkü teslimat veya yeniden denemeler birden fazla kez gerçekleşebilir.
Zaman aşımından sonra yinelenen ücretleri nasıl önlerim?
Görev gönderimiyle birlikte kararlı bir Idempotency-Key gönderin ve aynı mantıksal işi yeniden denediğinizde aynı değeri yeniden kullanın.
Video işleri nasıl faturalandırılır?
Mevcut API sayfası, 720p ve altı için saniyede 1,3 kredi ve 720p üzerinden 1080p'ye kadar saniyede 1,6 kredi listeler. Sabit tahminler kodlamadan önce güncel şartlar için geliştirici sayfasını kontrol edin.
API anahtarını ön uç kodunda kullanıma sunabilir miyim?
Hayır. userNo ve apiKey'i arka uç sunucunuzda tutun ve yetkili istekleri kendi sunucunuz üzerinden vekil olarak iletin.