Sobre o Topaz Denoise & Sharpen
Remove ruído ou corrige desfoque, mesma resolução, até 24 MP.
Chame com o nome de modelo topaz/denoise-sharpen/edit em POST /jobs/createTask, a partir de US$ 0,12.
Introdução
Topaz Denoise & Sharpen oferece duas famílias de modelos da Topaz Labs por meio de um único endpoint. O Denoise remove ruído e granulação tentando manter os detalhes reais; o Sharpen recupera a nitidez perdida por erro de foco, movimento ou lente suave. Você escolhe o modelo com preset; não há prompt.
Exemplo de requisição
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}Predefinições
| Predefinição | Use para |
|---|---|
denoise_normal | Ruído comum em pouca luz ou por compressão (padrão) |
denoise_strong | Fotos muito escuras ou com ISO alto; mantém mais detalhes que o Extreme |
denoise_extreme | Imagens muito degradadas ou muito comprimidas |
sharpen_standard | Leve falta de nitidez ou tremidinha; o ponto de partida mais usado |
sharpen_strong | Foco muito perdido |
sharpen_natural | Nitidez suave que preserva a textura orgânica |
sharpen_portrait | Rostos e pele |
sharpen_wildlife | Pelo, penas e outros detalhes naturais |
sharpen_refocus | Detalhes finos em uma foto levemente desfocada |
sharpen_motion_blur | Borrão causado pelo movimento da câmera ou do assunto |
sharpen_lens_blur | Desfoque de lente e falta de nitidez da lente |
Nossos testes
Um retrato de 2048×1152 iluminado por velas, com muito ruído de cor adicionado, ficou limpo em cerca de 19 segundos com denoise_normal; olhos, brincos e as luzes do bokeh se mantiveram, e as sardas ficaram mais suaves. Um retrato de café de 1024×1536 com granulação fina, enviado em WebP, perdeu o grão com denoise_strong em cerca de 25 segundos, enquanto os cachos e o padrão do tricô permaneceram. Um retrato de 1100×900 propositalmente borrado recuperou os olhos e a barba por fazer com sharpen_standard em 14 segundos. As três imagens voltaram no tamanho original.
Limites
O Denoise e o Sharpen são requisições separadas; encadeie-as se uma imagem precisar dos dois. O Sharpen reconstrói detalhes, então confira rostos e textos em tamanho real.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A imagem de partida. |
output_format | Não | Tipo de arquivo do resultado. jpeg · png · Padrão: jpeg |
preset | Não | Escolha uma das predefinições disponíveis para 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 · Padrão: denoise_normal |
Preços
Os preços são em USD. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
| Opção | USD por imagem |
|---|---|
| Padrão | US$ 0,12 |
Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. O orçamento não executa tarefas nem debita seu saldo.
Início rápido da API
Chame a API do Topaz Denoise & Sharpen em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow-. As chamadas usam seu saldo separado em dólares americanos.
- Envie a requisição. Faça POST /jobs/createTask com model topaz/denoise-sharpen/edit e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 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"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Topaz Denoise & Sharpen
Quanto custa a API do Topaz Denoise & Sharpen?
O Topaz Denoise & Sharpen custa US$ 0,12 por imagem. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo da cotação no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
Qual é o nome de modelo do Topaz Denoise & Sharpen na API?
Coloque topaz/denoise-sharpen/edit para Removedor de ruído no campo model de POST /jobs/createTask.
Escolho Normal, Strong ou Extreme?
Normal é o ponto de partida para o ruído do dia a dia causado por pouca luz ou compressão. Strong é para fotos muito escuras com ISO alto e preserva mais detalhe que o Extreme. Extreme foi feito para imagens muito degradadas ou bastante comprimidas e prioriza a limpeza em vez da textura fina.
A foto fica maior?
Não. Nosso teste de 2048×1152 voltou em 2048×1152 e o de 1100×900 em 1100×900. Se você também precisar de mais pixels, use um upscaler depois.
Qual preset de nitidez combina com um retrato?
sharpen_portrait é ajustado para pele e estrutura do rosto. Se o rosto estiver só um pouco suave, sharpen_standard ou sharpen_natural deixam o resultado mais perto do original; sharpen_strong é para foco claramente perdido.
Quais são os limites da API do Topaz Denoise & Sharpen?
Maior upload: 30 MB. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Topaz Denoise & Sharpen sem escrever código?
Execute Topaz Denoise & Sharpen no Playground com seu saldo de API em USD, sem chave de API. Cada execução aparece no histórico de desenvolvedor com o código correspondente.