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 el vídeo, sube un MP4 o MOV mediante /open/uploadVideo o facilita una videoUrl pública al llamar a /open/submitTask. Incluye las dimensiones, la duración y el rectángulo que se va a procesar. La tarea es asíncrona: consulta su estado con /open/taskDetail o /open/taskList.

Eliminación de marcas de agua de imagen

Para imágenes, /open/removeImageWatermark admite JPG, PNG, BMP, WebP, AVIF, TIFF y SVG de hasta 50 MB. Puede devolver el resultado directamente o un identificador para consultarlo después. Esta API no ofrece la descarga de vídeos con marca de agua a partir de enlaces; evita anunciar esa función en tu integración.

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 HTTP(S) accesible públicamente.

Autenticación y subida

Envía /open/submitTask con width, height, duration y x1, y1, x2, y2. Standard (mode=normal, opción predeterminada) procesa la zona dentro del rectángulo. Protect (mode=protect) conserva el interior y procesa el exterior; no ofrece una calidad superior. Indica removeAudio solo si hay que eliminar el audio 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 HTTP(S) 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

Las condiciones de entrada de la API pueden diferir de las del editor web. Comprueba la documentación vigente y valida formato, duración, dimensiones, profundidad de bits y HDR antes de enviar un archivo a un flujo que consume créditos.

Valida antes de gastar créditos

El resultado depende del movimiento y el detalle que rodean al texto. Un cielo o una pared uniforme suele ser más sencillo que manos, pelo, telas estampadas o reflejos. Revisa el vídeo completo, especialmente los fotogramas donde cambie el fondo.

Revisa los vídeos complejos

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

Una respuesta incluye code y message. En las tareas también pueden aparecer status, resultUrl y, si falla, failCode, failReason y refundStatus. Reintenta los problemas transitorios con esperas crecientes; corrige antes los parámetros inválidos, formatos no admitidos o falta de créditos.

Maneja campos de fallo estables

Registra el tiempo hasta completar cada tarea, los fallos, los resultados rechazados en revisión y el coste por archivo aprobado. Así podrás evaluar el trabajo útil que produce la integración.

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.