Introducción
Borra una región fija a lo largo de todo el video con una máscara de imagen blanca sobre negro. Una instrucción opcional describe la eliminación local; la misma máscara se aplica a todo el clip.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | El video completo que se procesará, de 1 a 600 segundos. La región seleccionada se procesa durante todo el clip. mínimo 1 caracteres |
mask_url | Sí | Una imagen PNG estática alineada con el fotograma del video. Pinta de blanco el área que se eliminará y de negro el área restante. mínimo 1 caracteres |
prompt | No | Indicaciones opcionales para la eliminación local. No seleccionan un intervalo de tiempo ni activan el seguimiento. |
Precios
$0.024 / segundo
Se factura por todo el clip de entrada, redondeando hacia arriba a segundos enteros, con un mínimo facturado de 3 segundos. Este endpoint acepta clips de 1 a 600 segundos; el tamaño de la máscara no reduce la duración.
Casos de uso
Video → Edición de video → Video
Edición de video
Video
Tarea asíncrona
Guía de prompts y consejos prácticos
Introducción
Video Eraser elimina el contenido dentro de una máscara de imagen estática a lo largo de todo un clip de video. Envía video_url y mask_url, junto con un prompt breve opcional que describa la eliminación. Es adecuado para una franja fija de subtítulos u otro elemento no deseado que permanezca en la misma región de la pantalla. El fondo resultante es un relleno inferido, no una recuperación de los píxeles originales ocultos.
Funciones principales y aspectos destacados
Una región fija para todo el clip
La máscara es una imagen fija: el blanco marca el área que se debe borrar y el negro, el área que se debe conservar. La misma región de la pantalla se aplica durante todo el video proporcionado. No hay un campo de tiempo de inicio, un campo de tiempo de fin ni un control de seguimiento de objetos en movimiento. Un subtítulo que se desplace fuera de la región blanca no quedará cubierto por esa máscara. El contenido que atraviese la región seleccionada también puede verse alterado por el relleno.
Una descripción opcional junto a la máscara
Una descripción breve puede aclarar qué se debe eliminar y qué hay a su alrededor. La máscara sigue siendo obligatoria en este endpoint para que la región quede definida de forma explícita. El procesamiento se factura por el clip de entrada completo, redondeando hacia arriba a segundos enteros, con una duración mínima facturada de 3 segundos. Se aceptan clips de origen de 1 a 600 segundos. Una máscara más pequeña no reduce la duración de video facturada.
Casos de uso
Eliminar una franja fija de subtítulos
Para subtítulos ya incrustados en tu propio material, marca la franja de subtítulos y revisa cada sección en la que aparezca texto. Un fondo estático es un buen punto de partida para comprobar el resultado. Si los subtítulos siguen siendo capas de texto editables en el proyecto, elimina esas capas directamente antes de optar por la reconstrucción de píxeles.
Limpiar una superposición inmóvil
Usa una máscara ajustada para una superposición no deseada en una esquina del material que estés editando. Revisa los fotogramas en los que una persona o un producto pasa por detrás del área seleccionada, o en los que un movimiento de cámara cambia el contenido que hay detrás de ella. En esos momentos, el relleno debe inferir contenido cambiante y puede revelar parpadeos o bordes distorsionados que no resultan evidentes en un solo fotograma de vista previa.
Guía de prompts y consejos prácticos
Crear una máscara inequívoca
Prepara una máscara PNG alineada con el fotograma de origen: blanco dentro de la región que se eliminará y negro fuera. Comprueba la posición en el primer fotograma, el intermedio y el último antes de enviarla. Evita regiones blancas innecesariamente grandes, sobre todo cuando se superpongan a un rostro o a un detalle importante del producto. La máscara es estática y afecta a todo el clip; no puede seguir subtítulos en movimiento ni limitar la edición a un intervalo de tiempo seleccionado.
Describir la edición local y comparar el resultado
Una instrucción opcional como «Elimina la franja fija de subtítulos y rellénala con el fondo circundante» describe el cambio deseado sin inventar una escena nueva. Compara la salida con el original a velocidad de reproducción normal y fotograma a fotograma en torno a los movimientos difíciles. Revisa las áreas sin máscara, la duración del clip, la frecuencia de fotogramas y el sonido, además de la región borrada. La conservación del audio original y la preservación exacta de los píxeles fuera de la máscara no se han verificado, así que guarda el archivo de origen.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.