API 550W do usuwania napisów i znaków wodnych

Co dokładnie obsługuje API deweloperskie 550W

API deweloperskie 550W umożliwia backendowi przesyłanie zadań usuwania napisów lub tekstu z filmów oraz zadań usuwania znaków wodnych z obrazów bez kierowania użytkowników przez edytor ręczny. Jest zaprojektowane dla platform twórców, potoków lokalizacji, bibliotek mediów i narzędzi wewnętrznych, które wielokrotnie przetwarzają treści należące do organizacji lub posiadające licencję na edycję.

Usuwanie napisów i tekstu z filmów

W przypadku filmów można przesłać materiał MP4 lub MOV przez /open/uploadVideo lub podać publiczny videoUrl do /open/submitTask. Żądanie zawiera wymiary filmu, czas trwania oraz prostokąt do naprawy. Zadania filmowe są wykonywane asynchronicznie i można je sprawdzać przez /open/taskDetail lub /open/taskList.

Usuwanie znaków wodnych z obrazów

W przypadku obrazów /open/removeImageWatermark akceptuje pliki JPG, PNG, BMP, WebP, AVIF, TIFF lub SVG do 50 MB. Może czekać na wynik lub zwrócić zadanie przetwarzania do późniejszego wyszukania. API deweloperskie Eraser nie udostępnia pobierania znaków wodnych z linków do filmów, więc integracje nie powinny obiecywać tej funkcji.

Używaj API do autoryzowanego usuwania napisów/tekstu z filmów i znaków wodnych z obrazów; nie umieszczaj nieobsługiwanych funkcji pobierania znaków wodnych z linków w obietnicach produktu.

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 HTTPS.

Uwierzytelnianie i przesyłanie

Prześlij /open/submitTask z width, height, duration oraz x1, y1, x2, y2. Ścisły prostokąt zwykle zachowuje więcej szczegółów niż naprawa na całym ekranie. Użyj mode=protect, gdy obsługiwany przepływ wymaga konserwatywnej rekonstrukcji, a removeAudio tylko wtedy, gdy dźwięk ma zostać usunięty przed przetwarzaniem.

Przesłanie idempotentnego zadania

Wyślij Idempotency-Key o długości nie większej niż 128 znaków w celu bezpiecznego tworzenia zadań przy ponawianiu. Jeśli po przesłaniu połączenie zostanie przerwane, ponów z tym samym kluczem zamiast tworzyć drugie zadanie rozliczane. Przechowuj zwrócony taskId obok własnego ID zasobu.

Odbiór i weryfikacja wyniku

W przypadku asynchronicznego dostarczania podaj publiczny callbackUrl HTTPS. Webhook uruchamia się, gdy zadanie osiągnie stan końcowy. Twój handler powinien szybko potwierdzić odebranie, ponownie zweryfikować zadanie przez /open/taskDetail i traktować powtórne dostarczenie webhooka jako normalne. Odpytywanie pozostaje użyteczne jako ścieżka odzyskiwania, gdy callback jest opóźniony.

Poświadczenia po stronie serwera, idempotencja, trwałe identyfikatory zadań i weryfikacja webhooków sprawiają, że ponawianie jest bezpieczne i obserwowalne.

Limity wejściowe i kontrola jakości

Przesłane filmy obsługują MP4 i MOV, maksymalny rozmiar pliku 1 GB, czas trwania do 600 sekund i przetwarzanie do 1080p w ramach udokumentowanych reguł wymiarów. Waliduj format, czas trwania, wymiary, głębię bitową i status HDR przed przesłaniem, aby nieobsługiwane media nigdy nie trafiły do płatnej kolejki.

Walidacja przed zużyciem kredytów

Jakość zależy od tego, co porusza się za napisami lub tekstem. Płaskie ściany, niebo i powoli zmieniające się krajobrazy są zwykle łatwiejsze niż dłonie, włosy, ubrania w wzory, odbicia lub szybki ruch kamery. Zbuduj kolejkę przeglądu dla przypadków brzegowych i porównuj całą oś czasu, nie tylko miniaturę.

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 dane wejściowe wcześnie i wymagaj przeglądu człowieka, gdy obszar naprawy przecina ważny ruchomy szczegół.

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

Pomyślne odpowiedzi zawierają code i message; odpowiedzi zadań dodatkowo expose status, a po zakończeniu resultUrl. Nieudane zadania mogą zawierać failCode, failReason i refundStatus. Ponawiaj tymczasowe błędy transportowe lub wewnętrzne z wykładniczym cofnięciem, ale nie ponawiaj ślepo nieprawidłowych parametrów, nieobsługiwanych mediów, zawieszonych kont lub błędów niewystarczających kredytów.

Obsługuj stabilne pola błędów

Rejestruj opóźnienie przesłania, opóźnienie ukończenia, współczynnik błędów, współczynnik odrzuceń przeglądu oraz koszt za zatwierdzony zasób. Te metryki ujawniają, czy automatyzacja poprawia przepływ pracy, a nie merely przenosi pracę ręczną w dół.

Przydatna integracja mierzy zatwierdzony wynik i efektywny koszt, a nie tylko pomyślne odpowiedzi HTTP.

Uruchom integrację w czterech krokach

Najpierw wygeneruj klucz API ze zlokalizowanej strony deweloperskiej 550W i prześlij jeden reprezentatywny film. Po drugie, zaimplementuj wyszukiwanie zadań i wyświetlaj stany oczekiwania, przetwarzania, sukcesu i błędu we własnym produkcie. Po trzecie, dodaj idempotencję i webhook z odzyskiwaniem przez odpytywanie. Na koniec uruchom kontrolowaną partię i przeglądaj każdy wynik przed zwiększeniem współbieżności.

Pilotuj przed skalowaniem

Używaj oddzielnych kontrolek deweloperskich i produkcyjnych, rotuj udostępnione poświadczenia, ograniczaj dostęp do materiałów źródłowych i utrzymuj politykę usuwania wyników. Zespoły z jasnymi kryteriami akceptacji mogą następnie połączyć API z DAM, CMS, kolejką lokalizacji lub przepływem pracy przesyłania twórców bez poświęcania przeglądu redakcyjnego.