Introducción
Aísla el primer plano de un clip existente y elige transparencia o un fondo de color sólido. La solicitud predeterminada pide WebM VP9 transparente con el audio original.
| Campo | Valor |
|---|---|
| Entrada | Video |
| Salida | Video |
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
video_url | Sí | Clip de origen de 1 a 60 segundos. La salida aísla el primer plano detectado; no hay control de recorte. mínimo 1 caracteres |
background | No | Elige transparencia o uno de diez colores sólidos. La salida transparente requiere un formato compatible con alfa. |
output_format | No | Preajuste de contenedor y códec. WebM VP9 es el predeterminado. |
keep_original_audio | No | Solicita el audio original en la salida; está activado de forma predeterminada. Desactívalo para obtener un clip sin sonido. Valor predeterminado: |
Precios
$0.06 / segundo
Se factura por segundo de video de entrada, redondeando hacia arriba al segundo entero. Este endpoint acepta clips de 1 a 60 segundos. Las opciones de fondo, formato y audio no cambian esta regla basada en 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
La herramienta para eliminar fondos de video aísla el primer plano de un video existente para composición o para colocarlo sobre un fondo de color sólido. Envía video_url y elige el fondo y el formato de exportación. La solicitud predeterminada pide WebM VP9 transparente y conserva el audio original. Este endpoint acepta clips de origen de 1 a 60 segundos; no genera una escena nueva a partir de un prompt.
Funciones clave y aspectos destacados
La transparencia depende del fondo y del formato elegidos
Establece background en transparent y usa un formato compatible con alfa. WebM VP9, MOV ProRes 4444, MKV VP9 y GIF son opciones documentadas con alfa. Los preajustes MP4 y los preajustes MKV H.264 o H.265 no incluyen alfa aquí; las solicitudes de transparencia incompatibles pueden rechazarse. MOV H.265 solo tiene compatibilidad documentada parcial, así que usa WebM VP9 para el flujo de trabajo transparente predeterminado y comprueba la salida real antes de componer.
Colores sólidos y sonido original
También puedes elegir negro, blanco, gris, rojo, verde, azul, amarillo, cian, magenta o naranja. keep_original_audio controla si se solicita el audio de origen en el resultado. GIF no puede contener una pista de audio; desactiva la conservación del audio al elegirlo. Las opciones de contenedor, códec y fondo no cambian la regla de facturación basada en la duración. Para facturar se usan los segundos de entrada redondeados hacia arriba, y este endpoint no ofrece controles de recorte ni de resolución de salida.
Casos de uso
Colocar a un presentador sobre una presentación
Empieza con un clip corto en el que el presentador esté claramente separado del fondo. Solicita WebM VP9 transparente y después coloca el resultado sobre la diapositiva o escena en un editor compatible con ese formato. Inspecciona el cabello y los bordes con desenfoque de movimiento sobre fondos oscuros y claros antes de publicar la composición.
Preparar un clip de producto para un nuevo diseño
Separa un producto de su entorno original para reutilizar el metraje en un diseño de catálogo o una edición para redes sociales. Exportar con un color sólido puede ser útil cuando no se necesita transparencia. Las superficies reflectantes y los bordes finos requieren una revisión minuciosa: el resultado es una máscara procesada y debe evaluarse sobre el fondo previsto, no solo en una vista previa de damero.
Guía de prompts y consejos prácticos
Elegir con criterio el formato de entrega
Mantén background=transparent, output_format=webm_vp9 y keep_original_audio=true para el flujo de trabajo de video predeterminado. Elige otro preajuste solo después de comprobar que tu editor puede importarlo. La compatibilidad de reproducción web varía según el navegador y el códec; que la descarga se complete no demuestra que una vista previa integrada o una edición posterior vayan a funcionar. Conserva el máster transparente cuando crees una vista previa independiente aplanada sobre un fondo para compartirla.
Verificar la transparencia y el clip completo
Inspecciona el canal alfa real y compón el resultado sobre negro, blanco y un color saturado. Que un archivo muestre un damero o un rectángulo negro no demuestra que la transparencia funcione. Revisa todo el movimiento para detectar cambios en los bordes y compara la duración, las dimensiones de los fotogramas y la sincronización del audio con el original. No deduzcas la presencia de alfa a partir del nombre del archivo o de las opciones seleccionadas. Esta integración aún no cuenta con una prueba completada de calidad de medios ni de compatibilidad con navegadores; valida el resultado con el flujo de trabajo que vayas a utilizar.
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-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"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.
