Borrador IAAcerca de Object Eraser
Elimina objetos no deseados de una foto nombrándolos o pintando una máscara; el espacio que dejan se rellena de acuerdo con la escena.
Llámalo con el nombre de modelo popnow/object-eraser-v1/edit en POST /jobs/createTask, desde 5 créditos por imagen (0,05 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. |
mask_url | No | Pinta la zona que debe cambiar. |
output_format | No | Tipo de archivo del resultado. png · jpeg · webp · Por defecto: png |
prompt | No | What to remove, in a few plain words with a position when there is more than one, e.g. "the wooden bench on the left". |
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 | 4,5 | 0,045 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 5 créditos por imagen (0,05 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 Object Eraser 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/object-eraser-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/object-eraser-v1/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "png"
}
}'
# 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 Object Eraser
¿Cuánto cuesta la API de Object Eraser?
Object Eraser cuesta 5 créditos (0,05 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 Object Eraser en la API?
Pon popnow/object-eraser-v1/edit para Borrador IA en el campo model de POST /jobs/createTask.
¿Necesito una máscara?
No siempre. Una descripción corta basta para un objeto bien definido y con espacio alrededor; en nuestras pruebas, un cucharón de madera desapareció solo con palabras. En cambio, los objetos delgados y los que tocan el borde del encuadre se pasan por alto a menudo, y la foto vuelve sin cambios: un rack alto en el borde del encuadre siguió ahí con dos descripciones distintas y desapareció al primer intento con una máscara. Envía mask_url cuando una descripción no funcione o para quitar solo uno de dos objetos parecidos.
¿Y si mi descripción no coincide con nada?
Recibes la foto sin cambios y la solicitud cuenta como completada. Nombra algo que de verdad esté en la imagen y agrega una posición si hay más de uno.
¿Cómo debe ser la máscara?
Del mismo tamaño que la foto, blanca sobre lo que debe desaparecer y negra en todo lo demás. Pinta un poco más allá del borde del objeto para que también se vayan su contorno y su sombra.
¿Puede poner algo nuevo en el hueco?
No. Quita y rellena el espacio con un entorno que combine.
¿Qué límites tiene la API de Object Eraser?
Longitud del prompt (caracteres): 1,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Object Eraser sin escribir código?
Sí. El Playground ejecuta Object Eraser con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.