API Video Eraser для обробки субтитрів і водяних знаків у відео та зображеннях

Що підтримує API розробника 550W

API 550W дає змогу серверу надсилати дозволені завдання для обробки субтитрів/тексту або видимого водяного знака у вибраному прямокутнику, а також водяних знаків на зображеннях. Доступ до API не надає прав на вихідний матеріал; результати потрібно перевіряти.

Обробка субтитрів і водяних знаків у відео

Відео MP4 чи MOV можна завантажити через /open/uploadVideo або передати публічний videoUrl до /open/submitTask. У запиті вказують розміри, тривалість і прямокутник для обробки. Завдання асинхронне; стан перевіряють через /open/taskDetail або /open/taskList.

Видалення водяних знаків із зображень

Для зображень /open/removeImageWatermark приймає JPG, PNG, BMP, WebP, AVIF, TIFF і SVG до 50 МБ. Метод може дочекатися результату або повернути завдання для подальшої перевірки. API Eraser не надає завантаження відео за посиланням для видалення водяного знака — не обіцяйте таку функцію користувачам.

Використовуйте API для дозволеного очищення тексту у відео й водяних знаків на зображеннях.

Надійна послідовність запитів

Кожен запит потребує userNo та apiKey. Зберігайте їх на сервері: ключ у браузерному чи мобільному коді можна витягти. Відео спочатку завантажують або передають за доступною HTTP(S)-адресою.

Перевірка доступу й завантаження

Надішліть до /open/submitTask параметри width, height, duration і x1, y1, x2, y2. Standard (mode=normal, за замовчуванням) обробляє ділянку всередині прямокутника. Protect (mode=protect) зберігає внутрішню ділянку й обробляє зовнішню; це не режим вищої якості. Застосовуйте removeAudio лише тоді, коли звук треба прибрати до обробки.

Ідемпотентне надсилання

Передавайте Idempotency-Key не довше 128 символів. Якщо зв’язок обірвався після надсилання, повторіть те саме логічне завдання з тим самим ключем, щоб не створити другу платну операцію. Збережіть taskId разом з ідентифікатором матеріалу.

Отримання та перевірка результату

Для асинхронного результату задайте публічний HTTP(S) callbackUrl. Після сповіщення про кінцевий стан швидко підтвердьте отримання та ще раз перевірте завдання через /open/taskDetail. Повторні сповіщення обробляйте безпечно, а опитування залиште резервним способом.

Серверні ключі, ідемпотентність, збережений taskId та перевірка вебхука роблять повтори керованими.

Обмеження й перевірка якості

Правила приймання файлів через API можуть відрізнятися від відеопроцесу в браузері. Звірте чинну документацію та до надсилання перевірте формат, тривалість, розміри, бітову глибину і HDR, щоб непідтримуваний файл не потрапив до платного процесу.

Перевіряйте файл до списання кредитів

Якість залежить від руху за написом. Рівна стіна чи небо зазвичай простіші за руки, волосся, візерунки, віддзеркалення та швидкий рух камери. Створіть чергу для складних результатів і переглядайте весь ролик, а не лише мініатюру.

Складні кадри передавайте на огляд

Завдання для зображень підтримують поширені формати; вартість успішного завдання перевіряйте на чинній сторінці API. Зберігайте оригінал, а результат — як окрему копію. Видалення водяного знака не надає авторських чи комерційних прав.

Відхиляйте непідтримувані файли заздалегідь і вимагайте людської перевірки складних ділянок.

Оплата, помилки й повторні спроби

Вартість видалення субтитрів залежить від тривалості й роздільності. Поточна ставка — 1,3 кредита за секунду до 720p включно та 1,6 вище 720p до 1080p. Тридцятисекундний ролик коштуватиме приблизно 39 або 48 кредитів відповідно. Перед великою серією перевірте баланс через /open/queryCredits.

Оцініть вартість перед відправленням

Відповідь містить code і message, завдання — status та після завершення resultUrl. У разі збою можуть бути failCode, failReason і refundStatus. Тимчасові мережеві помилки повторюйте зі зростанням затримки; некоректні параметри, непідтримуваний файл або нестачу кредитів спершу виправте.

Обробляйте сталі поля помилки

Фіксуйте час надсилання й завершення, частку збоїв, відхилень під час огляду та вартість одного схваленого матеріалу. Це показує, чи автоматизація справді допомагає редакторам.

Оцінюйте схвалені результати й фактичну вартість, а не лише успішні HTTP-відповіді.

Запустіть інтеграцію за чотири кроки

Створіть API-ключ на сторінці розробника й надішліть один типовий ролик. Далі показуйте у своєму продукті waiting, processing, success та failed. Додайте ідемпотентність, вебхук і резервне опитування. Тоді обробіть невелику серію й перегляньте кожен експорт перед збільшенням навантаження.

Спочатку невеликий пілот

Розділяйте розробницькі та робочі налаштування, змінюйте розкриті ключі, обмежуйте доступ до оригіналів і визначте строк видалення результатів. Підключайте API до медіатеки, CMS чи черги локалізації зі збереженням редакторської перевірки.