API Video Eraser do obsługi napisów i znaków wodnych w filmach oraz obrazach

Co dokładnie obsługuje API deweloperskie 550W

API deweloperskie 550W pozwala serwerowi wysyłać autoryzowane zadania obsługi napisów/tekstu lub widocznego znaku wodnego w wybranym prostokącie, a także znaków wodnych obrazów. Dostęp do API nie daje praw do materiału źródłowego; wynik trzeba sprawdzić.

Obsługa napisów i znaków wodnych w filmach

Prześlij plik MP4 lub MOV przez /open/uploadVideo albo podaj publiczny videoUrl w /open/submitTask. Dołącz wymiary, czas trwania i obszar do obróbki. Zadanie działa asynchronicznie; jego stan sprawdzisz przez /open/taskDetail lub /open/taskList.

Usuwanie znaków wodnych z obrazów

/open/removeImageWatermark przyjmuje JPG, PNG, BMP, WebP, AVIF, TIFF i SVG do 50 MB. Wywołanie może zwrócić gotowy wynik albo zadanie do późniejszego sprawdzenia. API nie pobiera wideo ze znakiem wodnym z linku, więc nie obiecuj takiej funkcji.

Używaj API do uprawnionej obróbki filmów i obrazów. Nie oferuj pobierania filmów ze znakiem wodnym z linku.

Gotowy do produkcji przepływ żądań

Każde żądanie jest uwierzytelniane za pomocą userNo i apiKey. Przechowuj obie wartości na swoim serwerze: umieszczenie klucza API w kodzie przeglądarki lub klienta mobilnego sprawia, że jest on odzyskiwany przez użytkowników i rozszerzenia. Film można najpierw przesłać lub podać jako publicznie dostępny adres URL HTTP(S).

Uwierzytelnianie i przesyłanie

Do /open/submitTask wyślij width, height, duration oraz x1, y1, x2, y2. Tryb Standard (mode=normal, domyślny) obrabia obszar wewnątrz zaznaczenia. Protect (mode=protect) zachowuje ten obszar i obrabia resztę kadru; nie jest trybem lepszej jakości. Ustaw removeAudio tylko wtedy, gdy chcesz usunąć dźwięk.

Przesłanie idempotentnego zadania

Dołącz Idempotency-Key o długości najwyżej 128 znaków. Gdy po wysłaniu zerwie się połączenie, ponów tę samą operację z tym samym kluczem, aby nie utworzyć drugiego płatnego zadania. Zapisz taskId przy własnym identyfikatorze pliku.

Odbiór i weryfikacja wyniku

Podaj publiczny callbackUrl HTTP(S) do odbioru powiadomienia. Szybko potwierdź webhook i ponownie sprawdź stan przez /open/taskDetail. Bezpiecznie obsłuż powtórzone wiadomości; w razie opóźnienia użyj odpytywania jako zapasowej ścieżki.

Klucze trzymane na serwerze, zabezpieczenie przed powtórzeniem zadania, zapisane identyfikatory i kontrola webhooka ułatwiają bezpieczne ponawianie.

Limity wejściowe i kontrola jakości

Wymagania API mogą różnić się od zasad edytora w przeglądarce. Sprawdź aktualną dokumentację i przed płatnym zgłoszeniem zweryfikuj format, długość, wymiary, głębię bitową i HDR.

Walidacja przed zużyciem kredytów

Wynik zależy od ruchu i szczegółów wokół tekstu. Jednolite niebo lub ściana zwykle są łatwiejsze niż dłonie, włosy, wzorzysta odzież czy odbicia. Obejrzyj cały eksport, zwłaszcza miejsca, w których zmienia się tło.

Przegląd trudnego materiału

Zadania obrazów obsługują popularne formaty internetowe i projektowe oraz kosztują ustaloną liczbę kredytów za pomyślne zadanie według bieżącej strony API. Zachowaj plik źródłowy i zapisz wynik jako plik pochodny; usunięcie znaku wodnego nie tworzy pozwolenia na prawa autorskie ani użytkowanie komercyjne.

Odrzucaj nieobsługiwane pliki przed wysłaniem i przekazuj trudne sceny do kontroli człowiekowi.

Rozliczenia, błędy i polityka ponawiania

Usuwanie napisów z filmów jest rozliczane według czasu trwania i rozdzielczości. Obecny cennik to 1,3 kredytu na sekundę przy 720p lub niższej oraz 1,6 kredytu na sekundę powyżej 720p do 1080p. 30-sekundowy film 1280×720 to zatem około 39 kredytów, podczas gdy 30-sekundowy film 1920×1080 to około 48 kredytów. Wyślij zapytanie /open/queryCredits przed przyjęciem dużej partii.

Oszacuj koszt przed przesłaniem

Odpowiedzi zawierają code i message. Zadanie może też mieć status, resultUrl oraz przy błędzie failCode, failReason i refundStatus. Błędy przejściowe ponawiaj z coraz dłuższą przerwą; wcześniej popraw błędne parametry, nieobsługiwany plik albo brak kredytów.

Obsługuj stabilne pola błędów

Mierz czas wykonania, odsetek błędów, wyniki odrzucone podczas kontroli i koszt zaakceptowanego pliku. To pokazuje, czy automatyzacja pomaga zespołowi.

Mierz liczbę zaakceptowanych plików i ich koszt, a nie tylko powodzenie wywołań HTTP.

Uruchom integrację w czterech krokach

Najpierw utwórz klucz API na stronie deweloperskiej 550W i wyślij reprezentatywny film. Potem pokaż w produkcie stany oczekiwania, przetwarzania, sukcesu i błędu. Dodaj ochronę przed podwójnym zleceniem, webhook i awaryjne odpytywanie. Przejrzyj każdy wynik małej partii próbnej przed zwiększeniem liczby równoległych zadań.

Pilotuj przed skalowaniem

Oddziel środowisko testowe od produkcyjnego, wymieniaj ujawnione klucze, ogranicz dostęp do źródeł i ustal zasady usuwania wyników. Dopiero przy jasnych kryteriach odbioru połącz API z biblioteką zasobów, CMS lub kolejką lokalizacji.