Introducción
Qué hace este endpoint
Ejecuta un modelo de Topaz Labs sobre una foto. Los presets de denoise eliminan grano, ruido de ISO alto y motas de compresión; los de nitidez recuperan el foco suave, la trepidación y el desenfoque del lente. La salida tiene el mismo ancho y alto que la entrada.
Entradas importantes
image_url acepta un JPEG, PNG o WebP de hasta 24 megapíxeles, subido o como enlace público. preset elige el modelo y por defecto es denoise_normal. output_format es jpeg (por defecto) o png.
Qué recibes
Una imagen por solicitud, entregada desde el almacenamiento de la plataforma cuando termina la tarea asíncrona. Las imágenes de más de 24 megapíxeles se rechazan al enviarlas con invalid_request.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Endpoint | Edición de imagen |
| Presets | 3 niveles de denoise, 8 modelos de nitidez |
| Prompt | Ninguno |
| Cobro | Precio fijo por imagen |
Funciones y aspectos destacados
Una foto de bar a la luz de las velas, sin motas y con el rostro intacto
Cubrimos un retrato de 2048×1152 con mucho ruido de color y lo pasamos por Denoise Normal. Las motas sobre el suéter y en los estantes oscuros de vino desaparecieron, mientras los ojos, el arete y las luces desenfocadas se quedaron en su sitio. Las pecas quedaron más tenues que en el original limpio.
Grano tipo película retirado de un retrato en una cafetería
Un WebP de 1024×1536 con grano gris fino sobre piel, cabello y un suéter tejido pasó por Denoise Strong en unos 25 segundos. El grano se fue, los rizos conservaron sus mechones y el suéter su punto; la piel quedó un poco más lisa.
Sharpen Standard devuelve la nitidez a un rostro suave
Un retrato que desenfocamos a propósito recuperó ojos, cejas y barba incipiente legibles en 14 segundos. El modelo reconstruye ese detalle, así que revisa el resultado a tamaño completo antes de confiar en él.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
image_url | Sí | La foto a limpiar: JPEG, PNG o WebP subido o como enlace público, de máximo 24 megapíxeles (6000×4000 entra). Las imágenes más grandes se rechazan al enviarlas, sin cobro. mínimo 1 caracteres |
preset | No | Qué modelo de Topaz se ejecuta. |
output_format | No | jpeg (por defecto) o png. png evita otra ronda de compresión con pérdida y genera un archivo más pesado. |
Precios
$0.12 / imagen
Cada imagen terminada tiene el mismo costo fijo, sin importar cuál de los once presets o de los dos formatos de salida elijas; una solicitud fallida o rechazada no cuesta nada.
Casos de uso
Fotos de celular de noche y en interiores
Las imágenes con ISO alto de conciertos, restaurantes o una sala oscura salen manchadas. Empieza con Denoise Normal y sube a Strong si las sombras siguen moteadas.
Grano en imágenes generadas con IA
Algunos modelos de imagen dejan un grano fino o una textura repetida sobre la piel y los fondos lisos. Una pasada de Denoise te da una base más limpia antes de escalar, recortar o imprimir.
Tomas casi enfocadas
Un foco apenas desviado, algo de trepidación o un lente blando. Sharpen Standard resuelve los casos leves, Motion Blur y Lens Blur atacan esos dos problemas, y Portrait o Wildlife están afinados para piel y pelaje.
Guía de prompts y consejos prácticos
Revisa el tamaño
Envía un JPEG, PNG o WebP de hasta 24 megapíxeles, como archivo subido o enlace público. Los archivos más grandes se rechazan al enviar la solicitud, así que redúcelos antes.
Elige un preset
Usa un preset denoise_ cuando el problema sea grano o motas, y uno sharpen_ cuando sea desenfoque. Cada solicitud ejecuta un solo preset; si necesitas ambos, primero quita el ruido y luego envía ese resultado a Sharpen.
Consulta y compara
Crea la tarea, consulta su estado hasta que termine y descarga el archivo del almacenamiento de la plataforma. Compáralo con el original al 100 % de zoom en ojos, cabello y texturas finas.
Introducción
Topaz Denoise & Sharpen reúne dos familias de modelos de Topaz Labs en un solo endpoint. Denoise elimina ruido y grano intentando conservar el detalle real; Sharpen devuelve la claridad perdida por errores de foco, movimiento o un lente blando. El modelo se elige con preset; no hay prompt.
Solicitud
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}
Presets
| preset | Úsalo para |
|---|---|
denoise_normal | Ruido cotidiano por poca luz o compresión (por defecto) |
denoise_strong | Tomas muy oscuras o con ISO alto; conserva más detalle que Extreme |
denoise_extreme | Imágenes muy degradadas o muy comprimidas |
sharpen_standard | Suavidad leve o poca trepidación; el punto de partida habitual |
sharpen_strong | Foco claramente fallido |
sharpen_natural | Nitidez moderada que respeta las texturas orgánicas |
sharpen_portrait | Rostros y piel |
sharpen_wildlife | Pelaje, plumas y otros detalles de naturaleza |
sharpen_refocus | Detalle fino en una imagen ligeramente desenfocada |
sharpen_motion_blur | Desenfoque por movimiento de la cámara o del sujeto |
sharpen_lens_blur | Desenfoque y suavidad del lente |
Nuestras pruebas
Un retrato con velas de 2048×1152 al que añadimos mucho ruido de color volvió limpio en unos 19 segundos con denoise_normal; los ojos, los aretes y las luces desenfocadas resistieron y las pecas se atenuaron. Un retrato de cafetería de 1024×1536 con grano fino, enviado como WebP, perdió el grano con denoise_strong en unos 25 segundos y conservó los rizos y el tejido del suéter. Un retrato de 1100×900 desenfocado a propósito recuperó ojos y barba con sharpen_standard en 14 segundos. Los tres volvieron con su tamaño de entrada.
Límites
Las entradas tienen un tope de 24 megapíxeles (6000×4000 entra); las imágenes más grandes se rechazan antes de cobrar. Denoise y Sharpen son solicitudes separadas, así que encadénalas si una imagen necesita ambas. La nitidez reconstruye detalle, por eso revisa rostros y texto a tamaño completo.
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": "topaz/denoise-sharpen/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "denoise_normal"
}
}'
# 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.
