Quitar fondoAcerca de Background Remover
Recorta el sujeto principal de cualquier foto con una sola llamada: el fondo queda totalmente transparente, en un PNG del mismo tamaño que tu imagen.
Llámalo con el nombre de modelo popnow/background-remover-v1/edit en POST /jobs/createTask, desde 1 crédito por imagen (0,01 US$). Las cuentas nuevas reciben 30 créditos gratis para que lo pruebes primero en el Playground.
Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La imagen de partida. |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por imagen | ≈ USD |
|---|---|---|
| Estándar | 0,72 | 0,0072 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 1 crédito por imagen (0,01 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Background Remover en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model popnow/background-remover-v1/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-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp"
}
}'
# 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 Background Remover
¿Cuánto cuesta la API de Background Remover?
Background Remover cuesta 1 crédito (0,01 US$) por imagen. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Background Remover en la API?
Pon popnow/background-remover-v1/edit para Quitar fondo en el campo model de POST /jobs/createTask.
¿Tengo que describir el sujeto?
No. El endpoint recibe un solo campo, image_url, y elige el primer plano por sí mismo. Si la foto tiene varios candidatos, recórtala antes al que quieres.
¿Qué recibo?
Un PNG con fondo transparente, con el mismo ancho y alto que la imagen que enviaste, para que puedas superponerlo directamente sobre el original.
¿Puede poner un fondo nuevo?
No en la misma llamada: solo quita. Coloca el PNG sobre tu propio color o foto, o crea una escena nueva con Image Expander y pon el recorte encima.
¿Qué fotos funcionan mejor?
Las que tienen un sujeto claro que se distingue de su entorno por color o luz. Los bordes con poco contraste, el desenfoque por movimiento y los sujetos cortados por el encuadre son donde el recorte falla.
¿Puedo probar Background Remover sin escribir código?
Sí. El Playground ejecuta Background Remover con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.