Video Eraser API ile video ve görsellerde altyazı ve filigran işleme

550W geliştirici API'si aslında ne destekliyor

550W geliştirici API’si, sunucunun yetkili videolarda altyazı/metin veya seçilmiş bir dikdörtgen içindeki görünür filigran için görev göndermesini ve görsel filigranlarını işlemesini sağlar. API erişimi kaynak içerik üzerinde hak vermez; sonuçlar incelenmelidir.

Video altyazılarını ve filigranlarını işleme

Video için MP4 veya MOV dosyasını /open/uploadVideo üzerinden yükleyin ya da /open/submitTask çağrısında herkese açık bir videoUrl verin. Boyutları, süreyi ve işlenecek dikdörtgeni ekleyin. Görev eşzamansız yürür; durumu /open/taskDetail veya /open/taskList üzerinden izleyin.

Görsel filigran kaldırma

/open/removeImageWatermark, 50 MB’a kadar JPG, PNG, BMP, WebP, AVIF, TIFF ve SVG kabul eder. Çağrı bir sonuç veya daha sonra sorgulanacak görev döndürebilir. API, bağlantıdan filigranlı video indirme işlevi sunmaz; ürününüzde böyle bir vaat kullanmayın.

API’yi yalnızca izinli video ve görsel düzenlemeleri için kullanın. Bağlantıdan filigranlı video indirme özelliği sunmayı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 HTTP(S) URL'si olarak sağlanabilir.

Kimlik doğrulama ve yükleme

/open/submitTask çağrısına width, height, duration ve x1, y1, x2, y2 ekleyin. Standard (mode=normal, varsayılan) seçilen dikdörtgenin içini işler. Protect (mode=protect) içini korur, dışını işler; daha kaliteli bir işlem seçeneği değildir. removeAudio değerini yalnızca sesi kaldırmanız gerektiğinde kullanın.

Değişmez bir iş gönderme

Her mantıksal görev için en çok 128 karakterlik bir Idempotency-Key gönderin. Gönderimden sonra bağlantı koparsa ikinci ücretli görevi açmamak için aynı anahtarla yeniden deneyin. Dönen taskId değerini kendi dosya kimliğinizle birlikte saklayın.

Sonucu alma ve doğrulama

Bildirimler için herkese açık bir HTTP(S) callbackUrl verin. Webhook geldiğinde hızlıca yanıtlayıp görevi /open/taskDetail ile tekrar kontrol edin. Yinelenen bildirimleri güvenle işleyin; gecikmelerde durum sorgulamayı yedek olarak kullanın.

Anahtarları sunucuda tutmak, yinelenen işleri önlemek, görev kimliklerini kaydetmek ve webhookları doğrulamak yeniden denemeyi güvenli kılar.

Giriş limitleri ve kalite kontrolleri

API giriş kuralları tarayıcıdaki video düzenleyiciden farklı olabilir. Güncel belgeleri kontrol edin; ücretli göreve geçmeden önce biçimi, süreyi, boyutları, bit derinliğini ve HDR durumunu doğrulayın.

Kredi harcayamadan önce doğrulayın

Sonuç, metnin çevresindeki ayrıntı ve harekete bağlıdır. Düz bir gökyüzü ya da duvar, ellerden, saçtan, desenli kıyafetlerden veya yansımalardan genellikle daha kolaydır. Özellikle arka planın değiştiği yerler dahil tüm çıktıyı izleyin.

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 dosyaları baştan reddedin; hareketli ve ayrıntılı sahneleri insan incelemesine gönderin.

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

Yanıtlarda code ve message bulunur. Görevler status, resultUrl ve hata durumunda failCode, failReason, refundStatus da içerebilir. Geçici hataları artan aralıklarla yeniden deneyin; geçersiz parametreleri, desteklenmeyen dosyaları ve yetersiz krediyi önce düzeltin.

Kararlı başarısızlık alanlarını işleyin

Görev süresini, hata oranını, incelemede reddedilen çıktıları ve onaylanan dosya başına maliyeti ölçün. Böylece otomasyonun gerçekten işe yarayıp yaramadığını görebilirsiniz.

Yalnızca HTTP başarısını değil, incelemeden geçen çıktı sayısını ve maliyetini de ölçün.

Entegrasyonu dört adımda başlatın

Önce 550W geliştirici sayfasından bir API anahtarı oluşturup temsilî bir video gönderin. Sonra ürününüzde bekleme, işleme, başarı ve hata durumlarını gösterin. Aynı görevin iki kez açılmasını önleyen anahtar, webhook ve yedek durum sorgulaması ekleyin. Eşzamanlı işleri artırmadan önce küçük bir deneme grubundaki her çıktıyı inceleyin.

Ölçeklenmeden önce pilot uygulama yapın

Geliştirme ve üretim ortamlarını ayırın, açığa çıkan anahtarları yenileyin, kaynak dosyalara erişimi sınırlandırın ve sonuçlar için saklama kuralı belirleyin. İnceleme ölçütleri netleşince API’yi medya arşivinize, CMS’ye veya yerelleştirme kuyruğuna bağlayın.