Topaz API
API de Topaz en WaveSpeedAI: modelos de mejora de imagen de Topaz Labs como endpoints REST. Sharpen para el desenfoque de lente y de movimiento, Denoise para el grano y el ruido de ISO alto, Restore para el polvo y los arañazos de fotos antiguas, y Lighting para exposición, balance de blancos y color.
Envía un JPEG o PNG y recibe una imagen mejorada: enfoca tomas blandas o desenfocadas, limpia fotos ruidosas con poca luz, elimina polvo y arañazos de copias escaneadas o corrige la exposición y la temperatura de color. Cada endpoint recibe la imagen, un modelo y un formato de salida, con el mismo flujo de predicción REST que el resto de modelos de WaveSpeedAI.
/filters:quality(82)/examples/f1eed2a7bfe888eb867d726036d8a338/1783683950126693744_2rEOX7gp.webp)
Resumen
Acerca de Topaz API
Qué hace Topaz, cómo encaja en la gama de modelos de Topaz Labs y por qué los equipos lo eligen.
Topaz es un modelo de escalado con IA de Topaz Labs, disponible a través de la API REST de WaveSpeedAI. API de Topaz en WaveSpeedAI: modelos de mejora de imagen de Topaz Labs como endpoints REST. Sharpen para el desenfoque de lente y de movimiento, Denoise para el grano y el ruido de ISO alto, Restore para el polvo y los arañazos de fotos antiguas, y Lighting para exposición, balance de blancos y color.
Envía un JPEG o PNG y recibe una imagen mejorada: enfoca tomas blandas o desenfocadas, limpia fotos ruidosas con poca luz, elimina polvo y arañazos de copias escaneadas o corrige la exposición y la temperatura de color. Cada endpoint recibe la imagen, un modelo y un formato de salida, con el mismo flujo de predicción REST que el resto de modelos de WaveSpeedAI.
La familia Topaz en WaveSpeedAI incluye 17 endpoints REST que cubren los flujos de trabajo de Video-Tools, Upscale-Video, Upscale-Image, Image-Tools. Cada variante tiene su propio precio, parámetros y ejemplos de resultados: elige la que se ajuste a tu modalidad de entrada y a tus requisitos de producción, o llama a varias con la misma clave de API para componer flujos de varios pasos.
Ejecuta Topaz con la misma clave de API, la misma cuenta de facturación y los mismos límites de uso que ya usas para los demás más de 1.000 modelos de IA de WaveSpeedAI. Sin configuración aparte por proveedor, sin SDK por proveedor, sin límites de uso distintos por proveedor: una sola integración lo cubre todo, desde texto a imagen y texto a vídeo hasta síntesis de audio, generación 3D, escalado y edición.
Especificaciones
Capacidades y estado de lanzamiento de Topaz API
Los detalles específicos del modelo que los desarrolladores buscan antes de elegir una API: disponibilidad, duración esperada del resultado, compatibilidad con referencias y la alternativa en producción actual.
Endpoints
Sharpen, Denoise, Restore, Lighting
Cuatro endpoints de imagen bajo topaz/image/, cada uno centrado en un tipo de corrección, para que un flujo ejecute solo los pasos que necesita cada imagen.
Entrada
JPEG o PNG
Cada endpoint recibe una sola imagen como URL o subida, sin necesidad de escribir un prompt.
Elección de modelo
Por endpoint
Un parámetro model elige la variante: estilos de nitidez para desenfoque de lente, desenfoque de movimiento, reenfoque, retratos y fauna salvaje; reducción de ruido Normal, Strong o Extreme; ajuste de iluminación, balance de blancos o colorización.
Formatos de salida
JPEG, PNG
JPEG es el valor predeterminado; configura output_format como png para obtener un resultado sin pérdida.
Endpoints
Todos los endpoints de la API de Topaz
17 endpoints de Topaz disponibles ahora en WaveSpeedAI: elige la variante que se ajuste a tu flujo de trabajo.
Video Deblur
Topaz Video Motion Deblur removes motion blur from fast-moving footage with Topaz Themis. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Hdr
Topaz Video SDR to HDR converts SDR video to 10-bit HDR with Topaz Hyperion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Frame Interpolation
Topaz Video Frame Interpolation raises frame rates and creates smooth slow motion with Topaz Apollo, Chronos and Aion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Denoise
Topaz Video Denoise removes noise and grain from video while keeping natural texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Creative
Topaz Video Upscale Creative creatively upscales AI-generated video with Topaz Astra, inventing new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Generative
Topaz Video Upscale Generative restores and upscales real and AI-generated video with Topaz Starlight diffusion models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale
Topaz Video Upscale upscales and enhances video up to 4K with Topaz's precision Proteus, Artemis, Gaia, Theia, Iris and Dione models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Transparent Upscale
Topaz Transparent Image Upscale upscales transparent PNG images while keeping the alpha channel intact. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Creative
Topaz Image Upscale Creative creatively upscales AI-generated images with Topaz Bloom, adding new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Generative
Topaz Image Upscale Generative upscales and repairs images with Topaz's generative Wonder, Recover and Redefine models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale
Topaz Image Upscale enlarges photos to 2K, 4K or 8K with precise, non-generative Topaz upscaling models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Denoise Generative
Topaz Image Denoise Max removes heavy noise and recovers lost detail with the generative Denoise Max model. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Sharpen Generative
Topaz Image Sharpen Generative rebuilds detail in severely blurred images with generative Super Focus models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112327_sqr1uegu.webp)
Image Sharpen
Topaz Image Sharpen sharpens soft, out-of-focus and motion-blurred photos while keeping them natural. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112312_o76ialis.webp)
Image Restore
Topaz Image Restore cleans dust, scratches and blemishes from scans and old photos. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112304_igpft99n.webp)
Image Lighting
Topaz Image Lighting fixes exposure and white balance, colorizes black-and-white photos and converts to HDR. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112318_eykl2kyy.webp)
Image Denoise
Topaz Image Denoise removes grain and high-ISO noise while preserving detail and texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Ejemplos
Mira Topaz en acción
Resultados reales generados con la API de Topaz. Pasa el cursor sobre cualquier vídeo para previsualizarlo y haz clic para abrir el visor a tamaño completo.
Cómo empezar
Cómo usar la API de Topaz
Cuatro pasos desde el registro hasta una generación terminada. Encontrarás ejemplos completos en Python, Node.js y cURL en la sección de API más abajo.
- 01
Obtén una clave de API
Regístrate en WaveSpeedAI y copia tu clave de API desde el panel. Las cuentas nuevas incluyen créditos gratuitos para empezar: suficientes para usar el playground unas decenas de veces antes de que empiece la facturación.
- 02
Envía una predicción
Haz POST de tu entrada como JSON a https://api.wavespeed.ai/api/v3/topaz/image/sharpen. El endpoint devuelve un id de predicción de inmediato: las generaciones son asíncronas, así que no mantienes una conexión abierta durante la inferencia.
- 03
Consulta hasta que termine
Haz GET a https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Devuelve los resultados con completed; detente con un error en failed, cancelled, timeout o deleted; sigue consultando con cualquier otro estado.
- 04
Lee la URL del resultado
Cuando status sea "completed", lee la URL de data.outputs[0]. La URL apunta a tu contenido generado en la CDN de WaveSpeedAI: imagen, vídeo, audio o archivo 3D según la variante de Topaz que hayas llamado.
Casos de uso
Qué puedes crear con Topaz
Flujos de trabajo habituales para los que desarrolladores y creadores usan la API de Topaz.
Corrige el desenfoque de lente y de movimiento
topaz/image/sharpen recupera detalle nítido en fotos blandas o desenfocadas, con variantes para desenfoque de lente, desenfoque de movimiento, reenfoque y nitidez de aspecto natural.
Retratos y fauna salvaje
El endpoint sharpen tiene variantes ajustadas para retratos y para fauna salvaje, de modo que rostros, pelaje y plumas ganan detalle sin halos.
Limpia tomas con poca luz y ISO alto
topaz/image/denoise elimina el grano y el ruido de ISO alto conservando el detalle, con intensidades Normal, Strong y Extreme para imágenes de poco a muy degradadas.
Restaura fotos antiguas y escaneadas
topaz/image/restore elimina polvo, arañazos y daños de copias antiguas y escaneos de película, para archivos familiares y proyectos de digitalización.
Corrige exposición, balance de blancos y color
topaz/image/lighting equilibra imágenes tomadas con mala luz, corrige la temperatura de color y puede añadir color natural a fotos en blanco y negro.
Limpieza por lotes para catálogos y subidas de usuarios
Pasa fichas de marketplace, fotos inmobiliarias o imágenes enviadas por usuarios por los endpoints que necesiten en un flujo automatizado, sin software de escritorio ni edición manual.
Consejos
Consejos para escribir prompts en Topaz
Consejos prácticos para obtener mejores resultados con Topaz, basados en los patrones que funcionan en modelos de escalado en flujos de producción.
- 01
Reduce el ruido antes de enfocar
Cuando una foto tiene ruido y además está blanda, ejecuta primero Denoise y después Sharpen. Enfocar una imagen ruidosa refuerza el grano junto con el detalle.
- 02
Elige la variante de sharpen según el desenfoque
Usa las variantes de desenfoque de lente o reenfoque para tomas desenfocadas, la de desenfoque de movimiento para trepidación de cámara o sujetos en movimiento, y las de retrato o fauna salvaje cuando el sujeto sean rostros o animales.
- 03
Empieza con la intensidad más suave
Prueba primero la reducción de ruido Normal y pasa a Strong o Extreme solo si aún se ve grano; los ajustes más fuertes suavizan la textura fina.
- 04
Usa PNG en flujos de varios pasos
Configura output_format como png cuando el resultado vaya a otro paso, como un escalado o una segunda corrección, para que cada pasada no añada compresión JPEG.
Precios
Precios de la API de Topaz
El precio es por resultado. El cargo final depende de los parámetros que definas en el playground de cada variante (resolución, duración, número de resultados, referencias).
| Endpoint | Tipo | Precio inicial |
|---|---|---|
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
API
Llama a la API de Topaz
Obtén una clave de API en wavespeed.ai/accesskey y envía una predicción por REST. El playground genera ejemplos listos para pegar con cualquier combinación de entradas.
POSThttps://api.wavespeed.ai/api/v3/topaz/image/sharpen
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/topaz/image/sharpen" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/topaz/image/sharpen";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/topaz/image/sharpen", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Comparar
Topaz frente a las alternativas
Cuándo elegir Topaz en lugar de modelos similares en WaveSpeedAI.
Topaz frente a Topaz Photo AI (desktop)
Topaz Photo AI es una aplicación de escritorio que se ejecuta en tu propio ordenador. Los endpoints de la API de Topaz se ejecutan en la nube y se llaman por REST, lo que encaja con servidores, trabajos por lotes y aplicaciones que procesan imágenes de sus propios usuarios.
Topaz frente a Image Upscaler Collection
La colección Image Upscaler sirve para aumentar la resolución. Los endpoints de Topaz corrigen la propia imagen: desenfoque, ruido, daños e iluminación, y a menudo se ejecutan antes o junto con un escalado.
Topaz frente a Self-hosted open-source models
Los modelos de código abierto de reducción de ruido y restauración requieren tus propias GPU y mantenimiento. Los endpoints de Topaz están alojados, se cobran por imagen y comparten una sola clave de API y cuenta de facturación con todos los demás modelos de WaveSpeedAI.
Preguntas frecuentes
Topaz API — Preguntas frecuentes
Precios, licencia, integración: preguntas habituales sobre cómo ejecutar Topaz en WaveSpeedAI.
¿Qué modelos de Topaz hay disponibles en WaveSpeedAI?
Los endpoints de imagen de Topaz para Sharpen, Denoise, Restore y Lighting están activos. Todos los endpoints de Topaz activos aparecen en la tabla de esta página con su precio actual.
¿Necesito un prompt?
No. Envía la imagen, elige una variante de modelo si quieres algo distinto del valor predeterminado y selecciona salida JPEG o PNG.
¿Cómo se cobran los endpoints de Topaz?
Por imagen, al precio que aparece en cada página de modelo y en la tabla de precios de arriba. WaveSpeedAI funciona con pago por uso: sin suscripción y con créditos que nunca caducan.
¿Qué es la API de Topaz?
Topaz es un modelo de upscaler de Topaz Labs expuesto como API REST en WaveSpeedAI. API de Topaz en WaveSpeedAI: modelos de mejora de imagen de Topaz Labs como endpoints REST. Sharpen para el desenfoque de lente y de movimiento, Denoise para el grano y el ruido de ISO alto, Restore para el polvo y los arañazos de fotos antiguas, y Lighting para exposición, balance de blancos y color. Puedes llamarlo por programación o probarlo desde el playground enlazado arriba.
¿Cómo llamo a la API de Topaz?
Regístrate en WaveSpeedAI, copia tu clave de API desde /accesskey y haz POST a https://api.wavespeed.ai/api/v3/topaz/image/sharpen con tu entrada como JSON. El endpoint devuelve un id de predicción. Consulta el endpoint de resultados aproximadamente cada 2 segundos, aumenta el intervalo en las tareas largas y detente ante cualquier estado final. Arriba tienes ejemplos en Python / Node.js / cURL orientados a producción.
¿Cuánto cuesta la API de Topaz?
Topaz empieza en $0.10. El coste exacto depende de los parámetros que definas (resolución, duración, número de resultados, referencias). La vista previa del coste en tiempo real junto al botón Generar del playground muestra el precio exacto de tu entrada actual.
¿Qué variantes de Topaz hay disponibles?
WaveSpeedAI aloja 17 endpoints de Topaz en producción: topaz/video/deblur, topaz/video/hdr, topaz/video/frame-interpolation, topaz/video/denoise, topaz/video/upscale-creative, topaz/video/upscale-generative, topaz/video/upscale, topaz/image/transparent-upscale y más. Cada variante tiene su propia página de playground y sus propios precios.
¿Puedo usar comercialmente los resultados de Topaz?
Los derechos de uso comercial dependen de la licencia del modelo de Topaz Labs. La mayoría de los modelos de Topaz Labs permiten el uso comercial de los resultados; consulta la página del playground de cada modelo para ver el resumen de su licencia y los Términos del servicio de WaveSpeedAI para las condiciones de la plataforma.
¿Por qué usar Topaz en WaveSpeedAI en lugar de ir directamente al proveedor?
Una sola clave de API y una sola cuenta de facturación para Topaz Y más de 1.000 modelos de IA de otros proveedores. Sin configurar un SDK por proveedor, sin límites de uso aparte y sin reescribir el código de integración para cada proveedor. Los precios suelen ser iguales o inferiores a los de la API directa de Topaz Labs.
Proveedor
Acerca de Topaz Labs
El equipo detrás de Topaz y de la gama más amplia de modelos de Topaz Labs en WaveSpeedAI.
Topaz Labs crea software de mejora de imagen y vídeo con IA utilizado por fotógrafos, cineastas y estudios, conocido por Gigapixel, Photo AI y Video AI. Sus modelos se centran en recuperar detalle real: nitidez, reducción de ruido, restauración y corrección de iluminación. En WaveSpeedAI, los modelos de Topaz están disponibles como endpoints REST con una sola clave de API y precios de pago por uso.
Empieza a crear con Topaz en WaveSpeedAI
Créditos gratuitos al registrarte. Una sola clave de API para más de 1.000 modelos de IA de Topaz Labs y de todos los demás proveedores.
/filters:quality(82)/examples/286559ad86f57a6240b138da36b60f72/1783683968956150943_aga01QGv.webp)
/filters:quality(82)/examples/0dce57b9a07f37936a242097f113443c/1783683972641647743_9sbjtCLV.webp)
/filters:quality(82)/examples/9fb30afa73b645f4b1a46f1db1b68526/1783683975803917626_0qGwk9YN.webp)
/filters:quality(82)/examples/4dfc9fa5d4e12a7bb42324519d201d3d/1783683978615057281_fGsBKT3c.webp)