API de Video Eraser para procesar subtítulos y marcas de agua en video e imágenes

Lo que realmente soporta la API para desarrolladores de 550W

La API para desarrolladores de 550W permite que un servidor envíe tareas autorizadas para procesar subtítulos o una marca de agua visible dentro de un rectángulo seleccionado, además de marcas de agua en imágenes. El acceso a la API no otorga derechos sobre el material original y los resultados deben revisarse.

Procesamiento de subtítulos y marcas de agua en video

Para video, sube un MP4 o MOV mediante /open/uploadVideo o proporciona una videoUrl pública a /open/submitTask. Envía dimensiones, duración y el rectángulo a procesar. La tarea se ejecuta de forma asíncrona; consulta /open/taskDetail o /open/taskList para conocer su estado.

Eliminación de marcas de agua de imagen

Para imágenes, /open/removeImageWatermark acepta JPG, PNG, BMP, WebP, AVIF, TIFF y SVG de hasta 50 MB. Puede entregar un resultado o una tarea para consultarla después. Esta API no ofrece descargas de videos con marca de agua a partir de enlaces; no anuncies esa función.

Use la API para limpieza autorizada de subtítulos/texto de video y eliminación de marcas de agua de imagen; mantenga fuera de la promesa de su producto los flujos de trabajo de marcas de agua de enlaces de video que no son compatibles.

Un flujo de solicitud listo para producción

Cada solicitud se autentica con userNo y apiKey. Mantenga ambos valores en su servidor: colocar una clave API en código de navegador o cliente móvil hace que sea recuperable por usuarios y extensiones. Un video se puede cargar primero o proporcionarse como una URL HTTP(S) accesible públicamente.

Autenticarse y cargar

Envía /open/submitTask con width, height, duration y x1, y1, x2, y2. Standard (mode=normal, opción predeterminada) procesa el área dentro del rectángulo. Protect (mode=protect) conserva el interior y procesa el exterior; no es un modo de mayor calidad. Usa removeAudio solo si necesitas quitar el audio antes del procesamiento.

Enviar un trabajo idempotente

Envíe una Idempotency-Key de no más de 128 caracteres para una creación segura ante reintentos. Si una conexión se corta después del envío, reintente con la misma clave en lugar de crear un segundo trabajo facturable. Almacene el taskId devuelto junto con su propio ID de activo.

Recibir y verificar el resultado

Para entrega asíncrona, proporcione una callbackUrl HTTP(S) pública. El webhook se activa cuando la tarea alcanza un estado final. Su manejador debe confirmar rápidamente, verificar la tarea nuevamente a través de /open/taskDetail y tratar la entrega repetida de webhook como algo normal. El sondeo sigue siendo útil como ruta de recuperación cuando una devolución de llamada se retrasa.

Credenciales del lado del servidor, idempotencia, IDs de tareas persistentes y verificación de webhook hacen que los reintentos sean seguros y observables.

Límites de entrada y controles de calidad

Las reglas de entrada de la API pueden ser distintas de las del editor web. Revisa la documentación actual y valida formato, duración, dimensiones, profundidad de bits y HDR antes de gastar créditos.

Validar antes de gastar créditos

El resultado depende del movimiento y los detalles alrededor del texto. Un cielo o una pared lisa suele ser más fácil que manos, cabello, ropa estampada o reflejos. Revisa el video completo y los momentos en que cambia el fondo.

Revisar material difícil

Los trabajos de imagen admiten formatos comunes de web y diseño y cuestan un número fijo de créditos por tarea exitosa según la página de API actual. Preserve el archivo fuente y guarde el resultado como un derivado; la eliminación de marcas de agua no crea permiso de derechos de autor o uso comercial.

Rechace temprano las entradas no compatibles y requiera revisión humana cada vez que el área de reparación cruce detalles importantes en movimiento.

Facturación, fallos y política de reintentos

La eliminación de subtítulos de video se factura por duración y resolución. El programa actual es de 1.3 créditos por segundo a 720p o menos y 1.6 créditos por segundo por encima de 720p hasta 1080p. Un video de 30 segundos a 1280×720 es por lo tanto aproximadamente 39 créditos, mientras que un video de 30 segundos a 1920×1080 es aproximadamente 48 créditos. Consulte /open/queryCredits antes de aceptar un lote grande.

Estimar el costo antes del envío

Las respuestas incluyen code y message. Una tarea también puede incluir status, resultUrl y, si falla, failCode, failReason y refundStatus. Reintenta fallas transitorias con intervalos crecientes; corrige los parámetros inválidos y los problemas de crédito antes de volver a enviar.

Manejar campos de fallo estables

Registre la latencia de envío, latencia de completación, tasa de fallo, tasa de rechazo de revisión y costo por activo aprobado. Estas métricas revelan si la automatización está mejorando el flujo de trabajo en lugar de simplemente mover trabajo manual río abajo.

Una integración útil mide la salida aprobada y el costo efectivo, no solo las respuestas HTTP exitosas.

Lance la integración en cuatro pasos

Primero, genere una clave API desde la página del desarrollador 550W localizada y envíe un video representativo. Segundo, implemente la búsqueda de tareas y muestre los estados de espera, procesamiento, éxito y fallo en su propio producto. Tercero, agregue idempotencia y un webhook con recuperación por sondeo. Finalmente, ejecute un lote controlado y revise cada salida antes de aumentar la concurrencia.

Haga una prueba piloto antes de escalar

Use controles separados de desarrollo y producción, rote las credenciales expuestas, restrinja el acceso al material fuente y mantenga una política de eliminación para los resultados. Los equipos con criterios de aceptación claros pueden luego conectar la API a un DAM, CMS, cola de localización o flujo de trabajo de carga de creadores sin sacrificar la revisión editorial.