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. Для 30 секунд это около 39 или 48 кредитов соответственно. Перед большой серией проверьте баланс через /open/queryCredits.

Оцените стоимость до отправки

Ответ содержит code и message, а задание — status и после завершения resultUrl. При ошибке доступны failCode, failReason и refundStatus. Временные сетевые сбои повторяйте с увеличением задержки; неверные параметры, неподдерживаемый файл или нехватку кредитов без исправления не отправляйте снова.

Учитывайте коды ошибок

Измеряйте время отправки и завершения, долю ошибок и отклонений при проверке, а также стоимость одного утверждённого результата. Так видно, действительно ли автоматизация помогает редакторам.

Оценивайте утверждённые результаты и реальную стоимость, а не только успешные HTTP-ответы.

Запуск интеграции за четыре шага

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

Сначала проведите пилот

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