API de Video Eraser para quitar subtítulos y marcas de agua
Lo que realmente soporta la API para desarrolladores de 550W
La API para desarrolladores de 550W permite que un backend envíe trabajos de eliminación de subtítulos o texto de video y trabajos de eliminación de marcas de agua de imagen sin llevar a los usuarios a través de un editor manual. Está diseñada para plataformas de creadores, pipelines de localización, bibliotecas de medios 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 video
Para video, envíe material MP4 o MOV a través de /open/uploadVideo o proporcione una videoUrl pública a /open/submitTask. La solicitud incluye dimensiones del video, duración y el rectángulo a reparar. Los trabajos de video se ejecutan de forma asíncrona y se pueden verificar 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 consulta posterior. La API para desarrolladores de Eraser no expone la descarga de marcas de agua de enlaces de video, por lo que las integraciones no deben prometer esa capacidad.
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 HTTPS accesible públicamente.
| Etapa | Endpoint | Almacene en su sistema |
|---|---|---|
| Cargar | /open/uploadVideo | videoUrl, coverUrl, dimensiones, duración |
| Enviar | /open/submitTask | taskId, clave de idempotencia, ID de activo |
| Monitorear | /open/taskDetail o /open/taskList | status, costo, campos de fallo y reembolso |
| Entregar | callbackUrl y resultUrl | derivado aprobado y evento de auditoría |
Autenticarse y cargar
Envíe /open/submitTask con width, height, duration y x1, y1, x2, y2. Un rectángulo ajustado generalmente preserva más detalle que una reparación de pantalla completa. Use mode=protect cuando el flujo de trabajo compatible requiera una reconstrucción conservadora, y removeAudio solo cuando el audio deba eliminarse 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 HTTPS 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
Los videos cargados admiten MP4 y MOV, un tamaño máximo de archivo de 1 GB, duración hasta 600 segundos y procesamiento hasta 1080p dentro de las reglas de dimensiones documentadas. Valide formato, duración, dimensiones, profundidad de bits y estado HDR antes de enviar para que el material no compatible nunca entre a la cola de pago.
Validar antes de gastar créditos
La calidad depende de lo que se mueva detrás del subtítulo o texto. Paredes planas, cielo y scenery que cambia lentamente generalmente son más fáciles que manos, cabello, ropa con patrones, reflejos o movimiento rápido de cámara. Construya una cola de revisión para casos extremos y compare toda la línea de tiempo, no solo una miniatura.
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 exitosas incluyen code y message; las respuestas de tarea además exponen status y, cuando está completo, resultUrl. Las tareas fallidas pueden incluir failCode, failReason y refundStatus. Reintente fallos temporales de transporte o internos con retroceso exponencial, pero no reintente ciegamente parámetros inválidos, material no compatible, cuentas suspendidas o errores de crédito insuficiente.
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.
Preguntas Frecuentes
¿Qué trabajos de video puedo enviar a través de la API?
La API para desarrolladores de Eraser acepta trabajos autorizados de eliminación de subtítulos o texto de video usando un archivo MP4/MOV cargado o una URL de video pública. No expone la descarga de marcas de agua de enlaces de video.
¿Debo hacer sondeo o usar un webhook?
Use un webhook para la completación normal y conserve el sondeo de detalles de tarea como ruta de recuperación. Haga que ambos manejadores sean idempotentes porque la entrega o los reintentos pueden ocurrir más de una vez.
¿Cómo evito cargos duplicados después de un tiempo de espera?
Envíe una Idempotency-Key estable con el envío de tarea y reutilice el mismo valor al reintentar el mismo trabajo lógico.
¿Cómo se facturan los trabajos de video?
La página de API actual lista 1.3 créditos por segundo a 720p o menos y 1.6 créditos por segundo por encima de 720p hasta 1080p. Consulte la página del desarrollador para los términos actuales antes de codificar estimaciones.
¿Puedo exponer la clave API en código del frontend?
No. Mantenga userNo y apiKey en su backend y envíe las solicitudes autorizadas a través de su propio servidor.