Acerca de Video Background Remover
Un video maestro transparente para tu próxima composición.
Llámalo con el nombre de modelo popnow/background-remover-video-v1/video-edit en POST /jobs/createTask, desde 0,06 US$.
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
background | No | Mantener, quitar o reemplazar el fondo. transparent · black · white · gray · red · green · blue · yellow · cyan · magenta · orange · Por defecto: transparent |
keep_original_audio | No | Keep the source audio in an output format that supports audio. GIF does not carry sound. Por defecto: true |
output_format | No | Tipo de archivo del resultado. webm_vp9 · mp4_h264 · mp4_h265 · mov_h265 · mov_proresks · mkv_h264 · mkv_h265 · mkv_vp9 · gif · Por defecto: webm_vp9 |
video_url | Sí | El clip con el que trabajar. |
Precios
Los precios se indican en USD. La API utiliza un saldo independiente en dólares estadounidenses. Los créditos de la web no sirven para la API ni se pueden convertir en saldo de API; tampoco se puede convertir el saldo de API en créditos de la web. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.
| Opción | USD por segundo de entrada |
|---|---|
| Estándar | 0,06 US$ |
La duración de entrada se redondea al segundo entero superior, con un mínimo de 1 segundos.
Antes de ejecutar, envía el mismo cuerpo de petición a POST /jobs/quote para consultar el coste estimado y el máximo en USD. El presupuesto no ejecuta tareas ni carga tu saldo.
Inicio rápido de la API
Llama a la API de Video Background Remover en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola API. Las claves empiezan por sk-popnow-. Las llamadas utilizan tu saldo independiente en dólares estadounidenses.
- Envía la solicitud. Haz POST /jobs/createTask con model popnow/background-remover-video-v1/video-edit y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/background-remover-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Video Background Remover
¿Cuánto cuesta la API de Video Background Remover?
Video Background Remover cuesta 0,06 US$ por segundo. La API utiliza un saldo independiente en dólares estadounidenses. Los créditos de la web no sirven para la API ni se pueden convertir en saldo de API; tampoco se puede convertir el saldo de API en créditos de la web. Al aceptar una tarea, reservamos el importe máximo del presupuesto en tu saldo de API. Al terminar, cobramos el uso real sin superar la reserva y liberamos el resto. Si la tarea falla, liberamos el importe reservado.
¿Cuál es el nombre de modelo de Video Background Remover en la API?
Pon popnow/background-remover-video-v1/video-edit para Quitar fondo del video en el campo model de POST /jobs/createTask.
¿Qué ajustes solicitan una salida transparente?
Usa background=transparent con output_format=webm_vp9. Conserva el máster con alfa resultante para composición y verifica el canal real antes de usarlo.
¿La conservación del audio se aplica a GIF?
No. GIF no tiene pista de audio. Desactiva keep_original_audio al solicitar GIF.
¿Puedo dar por hecho que el resultado funciona en todos los navegadores?
No. La compatibilidad con contenedores y códecs varía. Comprueba la reproducción y la edición en el navegador o la aplicación donde se utilizará el resultado.
¿Qué límites tiene la API de Video Background Remover?
Clip de entrada más largo: 60 s. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Video Background Remover sin escribir código?
Ejecuta Video Background Remover en el Playground con tu saldo de API en USD, sin clave API. Cada ejecución aparece en tu historial de desarrollador con el código correspondiente.