API de Video Eraser para eliminar subtítulos y marcas de agua

Lo que realmente soporta la API para desarrolladores de 550W

La API para desarrolladores de 550W permite a un backend enviar tareas de eliminación de subtítulos o texto de vídeo y de eliminación de marcas de agua de imagen sin necesidad de llevar a los usuarios a través de un editor manual. Está diseñada para plataformas de creadores, tuberías de localización, bibliotecas multimedia y herramientas internas que procesan repetidamente contenido que la organización posee o tiene licencia para editar.

Eliminación de subtítulos y texto de vídeo

Para vídeo, envía archivos MP4 o MOV a través de /open/uploadVideo o proporciona una videoUrl pública a /open/submitTask. La solicitud incluye dimensiones del vídeo, duración y el rectángulo a reparar. Las tareas de vídeo se ejecutan de forma asíncrona y se pueden consultar a través de /open/taskDetail o /open/taskList.

Eliminación de marcas de agua de imagen

Para imágenes, /open/removeImageWatermark acepta archivos JPG, PNG, BMP, WebP, AVIF, TIFF o SVG de hasta 50 MB. Puede esperar un resultado o devolver una tarea de procesamiento para consultar posteriormente. La API para desarrolladores de Eraser no expone la descarga de marcas de agua de enlaces de vídeo, por lo que las integraciones no deben prometer esa funcionalidad.

Utiliza la API para la limpieza autorizada de subtítulos/texto de vídeo y eliminación de marcas de agua de imagen; mantén los flujos de trabajo de marcas de agua de enlaces de vídeo no admitidos fuera de la promesa de tu producto.

Un flujo de solicitudes listo para producción

Cada solicitud se autentica con userNo y apiKey. Mantén ambos valores en tu servidor: colocar una clave API en código de navegador o cliente móvil hace que sea recuperable por usuarios y extensiones. Un vídeo puede subirse primero o proporcionarse como una URL HTTPS accesible públicamente.

Autenticación y subida

Envía /open/submitTask con width, height, duration y x1, y1, x2, y2. Un rectángulo ajustado suele preservar más detalle que una reparación de pantalla completa. Utiliza mode=protect cuando el flujo de trabajo soportado requiera una reconstrucción conservadora, y removeAudio solo cuando el audio deba eliminarse antes del procesamiento.

Envío de una tarea idempotente

Envía un Idempotency-Key de no más de 128 caracteres para una creación segura ante reintentos. Si una conexión se cae después del envío, reintenta con la misma clave en lugar de crear una segunda tarea facturable. Almacena el taskId devuelto junto con tu propio ID de activo.

Recepción y verificación del resultado

Para la entrega asíncrona, proporciona una callbackUrl HTTPS pública. El webhook se activa cuando la tarea alcanza un estado final. Tu manejador debe confirmar rápidamente, verificar la tarea nuevamente a través de /open/taskDetail y tratar la entrega repetida del webhook como algo normal. El polling sigue siendo útil como ruta de recuperación cuando una llamada de retorno se retrasa.

Las credenciales del lado del servidor, idempotencia, IDs de tarea duraderos y verificación de webhook hacen que los reintentos sean seguros y observables.

Límites de entrada y controles de calidad

Los vídeos subidos soportan MP4 y MOV, un tamaño máximo de archivo de 1 GB, duración de hasta 600 segundos y procesamiento hasta 1080p dentro de las reglas de dimensiones documentadas. Valida el formato, duración, dimensiones, profundidad de bits y estado HDR antes de enviar para que los medios no admitidos nunca entren en la cola de pago.

Valida antes de gastar créditos

La calidad depende de lo que se mueva detrás del subtítulo o texto. Las paredes planas, el cielo y los paisajes que cambian lentamente suelen ser más fáciles que las manos, el pelo, la ropa con patrones, los reflejos o el movimiento rápido de cámara. Construye una cola de revisión para casos límite y compara toda la línea de tiempo, no solo una miniatura.

Revisa footage difícil

Las tareas de imagen soportan formatos web y de diseño comunes y cuestan un número fijo de créditos por tarea exitosa según la página actual de la API. Preserva el archivo fuente y guarda el resultado como una derivada; la eliminación de marcas de agua no crea permiso de derechos de autor o uso comercial.

Rechaza temprano las entradas no admitidas y requiere revisión humana siempre que el área de reparación cruce detalles móviles importantes.

Facturación, fallos y política de reintentos

La eliminación de subtítulos de vídeo se factura por duración y resolución. El programa actual es de 1,3 créditos por segundo a 720p o inferior y 1,6 créditos por segundo por encima de 720p hasta 1080p. Un vídeo de 30 segundos a 1280×720 es por tanto aproximadamente 39 créditos, mientras que un vídeo de 30 segundos a 1920×1080 es aproximadamente 48 créditos. Consulta /open/queryCredits antes de aceptar un lote grande.

Estima el coste antes del envío

Las respuestas exitosas incluyen code y message; las respuestas de tareas exponen adicionalmente status y, cuando están completas, resultUrl. Las tareas fallidas pueden incluir failCode, failReason y refundStatus. Reintenta fallos temporales de transporte o internos con retrotrayecto exponencial, pero no reintentes ciegamente parámetros inválidos, medios no admitidos, cuentas suspendidas o errores de crédito insuficiente.

Maneja campos de fallo estables

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

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

Lanza la integración en cuatro pasos

Primero, genera una clave API desde la página del desarrollador de 550W localizada y envía un vídeo representativo. Segundo, implementa la búsqueda de tareas y muestra los estados de espera, procesamiento, éxito y fallido en tu propio producto. Tercero, añade idempotencia y un webhook con recuperación por polling. Finalmente, ejecuta un lote controlado y revisa cada salida antes de aumentar la concurrencia.

Piloto antes de escalar

Utiliza controles separados de desarrollo y producción, rota las credenciales expuestas, restringe el acceso a los medios de origen y mantén 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 subida de creadores sin sacrificar la revisión editorial.