Introducción
Qué hace este endpoint
Separa al sujeto principal de un video de todo lo que hay detrás, sin pantalla verde ni paso de selección. El cabello, el pelaje y las telas sueltas conservan bordes suaves.
Entradas importantes
video_url recibe un clip de 120 segundos como máximo. output_format define el resultado: mp4, webm o matte. Con mp4 puedes añadir background_image_url o background_video_url. resolution es 480p o 720p.
Qué recibes
Un video con la relación de aspecto y la duración del original, con su sonido.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
| Endpoint | Edición de video |
| Fondos | Tu imagen o video (solo mp4); blanco si no hay |
| Salidas | MP4, WebM transparente (alfa VP9) o MP4 de mate en blanco y negro |
| Resolución | 480p o 720p, se mantiene la relación de aspecto original |
| Cobro | Segundos del original × tarifa de la resolución elegida; mínimo 3 s |
Funciones y aspectos destacados
De una terraza junto al mar a una azotea de la ciudad
Tomamos un clip de 5 segundos de una mujer en una terraza sobre el mar y enviamos como fondo un video de una azotea al atardecer. Volvió parada en la azotea, con el cabello largo todavía en mechones sueltos, el fondo en movimiento detrás y el sonido del clip intacto. Con una imagen fija funciona igual; sin ningún fondo, el MP4 vuelve sobre blanco.
Un mate en blanco y negro para tu propia composición
La salida matte es un MP4 en el que el sujeto es blanco y todo lo demás negro, con la misma duración y cuadros por segundo que el original. Combínalo con el clip original en un editor que admita clave por luminancia.
WebM con canal alfa real
Elige webm para obtener un archivo VP9 con fondo transparente, listo para colocar sobre una partida, unas diapositivas u otra toma. Chrome, Edge y Firefox muestran la transparencia; Safari reproduce el mismo archivo sobre negro.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | El clip a procesar: un MP4 o WebM subido o un enlace directo al archivo, de 120 segundos como máximo. Si supera ese límite se rechaza antes de procesarlo, sin costo. mínimo 1 caracteres |
output_format | No | mp4 (predeterminado) devuelve al sujeto sobre tu imagen o video de fondo, o sobre blanco. webm devuelve VP9 con transparencia (Safari lo muestra sobre negro). |
background_image_url | No | Opcional: JPEG, PNG o WebP que va detrás del sujeto y se escala para llenar el cuadro. Solo con |
background_video_url | No | Opcional: MP4 o WebM que va detrás del sujeto, se escala para llenar el cuadro y se repite en bucle si es más corto que el clip. mínimo 1 caracteres |
resolution | No | Tamaño de salida: 480p o 720p (predeterminado). Se mantiene la relación de aspecto original. |
Precios
Se cobra por segundo del clip original a la tarifa de la resolución elegida, redondeando al segundo completo hacia arriba, con un mínimo de 3 segundos. Los clips de más de 120 segundos se rechazan al enviarlos. El formato de salida y el fondo no cambian el precio. Las solicitudes fallidas no se cobran.
| Especificación | Precio |
|---|---|
| $0.024 / segundo |
| $0.048 / segundo |
Casos de uso
Presentadores frente a un set de marca
Pon a alguien grabado en una habitación común frente a una imagen de estudio o un fondo animado en bucle, sin pantalla verde ni volver a grabar.
Superposiciones para edición y streaming
Un WebM transparente de una bailarina, una mascota o un producto puede ir sobre una partida, unas diapositivas u otra toma en cualquier editor que lea alfa VP9.
Pistas de clave para composición
La salida matte entrega una pista limpia en blanco y negro para combinar con el clip original en After Effects, DaVinci Resolve o flujos al estilo de Nuke.
Guía de prompts y consejos prácticos
Sube un clip con un sujeto claro
La detección es automática: no hay prompt ni selección con clics. Una sola persona u objeto frente a la cámara da el recorte más limpio. Los clips pueden durar hasta 120 segundos.
Elige qué quieres recibir
mp4 para una toma terminada con fondo nuevo, webm si necesitas transparencia, matte si tu editor espera una pista de clave. La imagen o el video de fondo solo se usan con mp4.
Revisa en 480p y entrega en 720p
Ambos tamaños mantienen la relación de aspecto del original. El segundo en 720p cuesta el doble que en 480p, así que revisa primero el recorte con una pasada corta en 480p.
Introducción
Video Background Remover Pro toma un clip común, encuentra a la persona u objeto frente a la cámara y lo separa de la escena. Tú decides qué recibes: el sujeto sobre un fondo nuevo, el sujeto solo sobre transparencia o un mate en blanco y negro para usar como clave en tu editor.
Solicitud
{
"video_url": "https://example.com/beach.mp4",
"background_video_url": "https://example.com/city-lights.mp4",
"output_format": "mp4",
"resolution": "720p"
}
Solo video_url es obligatorio. output_format es mp4 por defecto y resolution es 720p. Envía como mucho uno de background_image_url y background_video_url, y solo con mp4; sin ninguno, el sujeto queda sobre blanco.
Las tres salidas
mp4: una toma terminada. La imagen de fondo se escala para llenar el cuadro; el video de fondo también, y se repite en bucle si es más corto que tu clip.webm: VP9 con canal alfa. Chrome, Edge y Firefox lo muestran transparente; Safari lo reproduce sobre negro.matte: un MP4 en el que el sujeto es blanco y todo lo demás negro, alineado cuadro por cuadro con tu original.
Qué vimos en las pruebas
Usamos un clip de playa de 3 segundos en 16:9: una mujer con el cabello al viento frente a un sol bajo. En 480p cada salida volvió en 854×480 a 24 fps, y en 720p en 1280×720; el procesamiento tardó entre uno y dos minutos por clip. Un clip más ancho de terraza, en 2:1, volvió en 906×452 a 25 fps: el tamaño sigue la cantidad de píxeles del ajuste elegido en vez de una altura fija, y se respetan los cuadros por segundo del original. Los mechones finos se mantuvieron separados en el mate, el WebM se decodificó con un canal alfa real y las versiones MP4 conservaron el audio original. Un clip de 2 segundos se cobró como 3, el mínimo.
Flujo de la tarea
La llamada es asíncrona: crea la tarea, consúltala hasta que termine y luego descarga el video desde el almacenamiento de SpicyAPI. Las solicitudes fallidas no se cobran.
Consejos
- Corta el clip a la parte que necesitas antes de subirlo; el cobro sigue la duración del original.
- Funciona mejor con un solo sujeto claro. Si hay varias personas en cuadro, la herramienta decide cuál es el sujeto.
- Si la transparencia también debe verse en Safari, usa el mate junto con el clip original en lugar del WebM.
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/background-remover-video-pro/video-edit",
"input": {
"output_format": "mp4",
"resolution": "720p",
"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.



