Acerca de Topaz Denoise & Sharpen
Quita ruido o corrige el desenfoque, misma resolución, hasta 24 MP.
Llámalo con el nombre de modelo topaz/denoise-sharpen/edit en POST /jobs/createTask, desde 0,12 US$.
Introducción
Topaz Denoise & Sharpen te ofrece dos familias de modelos de Topaz Labs a través de un solo endpoint. Denoise elimina el ruido y el grano intentando conservar el detalle real; Sharpen recupera la nitidez perdida por errores de enfoque, movimiento o una lente blanda. Eliges el modelo con preset; no necesitas prompt.
Ejemplo de solicitud
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}Preajustes
| Preajuste | Para qué sirve |
|---|---|
denoise_normal | Ruido habitual en poca luz o por compresión (predeterminado) |
denoise_strong | Fotos muy oscuras o con ISO alto; conserva más detalle que Extreme |
denoise_extreme | Imágenes muy degradadas o muy comprimidas |
sharpen_standard | Ligera falta de nitidez o leve temblor; el punto de partida habitual |
sharpen_strong | Enfoque muy fallido |
sharpen_natural | Enfoque suave que conserva la textura orgánica |
sharpen_portrait | Rostros y piel |
sharpen_wildlife | Pelaje, plumas y otros detalles naturales |
sharpen_refocus | Detalle fino en una foto ligeramente desenfocada |
sharpen_motion_blur | Desenfoque por movimiento de la cámara o del sujeto |
sharpen_lens_blur | Desenfoque de lente y pérdida de nitidez óptica |
Nuestras pruebas
Un retrato de 2048×1152 iluminado por velas, con mucho ruido de color añadido, quedó limpio en unos 19 segundos con denoise_normal; los ojos, los pendientes y las luces del bokeh se mantuvieron y las pecas se aclararon. Un retrato de café de 1024×1536 con grano fino, enviado como WebP, perdió el grano con denoise_strong en unos 25 segundos, mientras que los rizos y el patrón del punto se conservaron. Un retrato de 1100×900 deliberadamente borroso recuperó los ojos y la barba incipiente con sharpen_standard en 14 segundos. Las tres imágenes se devolvieron con su tamaño original.
Límites
Denoise y Sharpen son solicitudes separadas, así que encadénalas si una imagen necesita ambas. Sharpen reconstruye detalles, por lo que conviene revisar rostros y textos a tamaño completo.
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La imagen de partida. |
output_format | No | Tipo de archivo del resultado. jpeg · png · Por defecto: jpeg |
preset | No | Elige uno de los ajustes predefinidos de este modelo. denoise_normal · denoise_strong · denoise_extreme · sharpen_standard · sharpen_strong · sharpen_natural · sharpen_portrait · sharpen_wildlife · sharpen_refocus · sharpen_motion_blur · sharpen_lens_blur · Por defecto: denoise_normal |
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 imagen |
|---|---|
| Estándar | 0,12 US$ |
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 Topaz Denoise & Sharpen 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 topaz/denoise-sharpen/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": "topaz/denoise-sharpen/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"preset": "denoise_normal",
"output_format": "jpeg"
}
}'
# 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 Topaz Denoise & Sharpen
¿Cuánto cuesta la API de Topaz Denoise & Sharpen?
Topaz Denoise & Sharpen cuesta 0,12 US$ por imagen. 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 de la cotización 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 Topaz Denoise & Sharpen en la API?
Pon topaz/denoise-sharpen/edit para Eliminador de ruido en el campo model de POST /jobs/createTask.
¿Elijo Normal, Strong o Extreme?
Normal es el punto de partida para el ruido cotidiano por poca luz o compresión. Strong es para tomas muy oscuras con ISO alto y conserva más detalle que Extreme. Extreme está pensado para imágenes muy degradadas o muy comprimidas y prioriza un resultado limpio sobre la textura fina.
¿La foto sale más grande?
No. Nuestra prueba de 2048×1152 volvió en 2048×1152 y la de 1100×900 en 1100×900. Si además necesitas más píxeles, usa después un escalador.
¿Qué preset de nitidez conviene para un retrato?
sharpen_portrait está afinado para piel y rasgos faciales. Si el rostro solo está un poco suave, sharpen_standard o sharpen_natural dejan el resultado más cerca del original; sharpen_strong es para un foco claramente fallido.
¿Qué límites tiene la API de Topaz Denoise & Sharpen?
Subida máxima: 30 MB. Las solicitudes fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Topaz Denoise & Sharpen sin escribir código?
Ejecuta Topaz Denoise & Sharpen 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.