PopNowAPI
Pegue sua chave de API

Topaz Denoise & Sharpen API

da Topaz Labs

Remove ruído ou corrige desfoque, mesma resolução, até 24 MP

topaz/denoise-sharpen/edit
  • Removedor de ruído

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çãoUse para
denoise_normalRuído comum em pouca luz ou por compressão (padrão)
denoise_strongFotos muito escuras ou com ISO alto; mantém mais detalhes que o Extreme
denoise_extremeImagens muito degradadas ou muito comprimidas
sharpen_standardLeve falta de nitidez ou tremidinha; o ponto de partida mais usado
sharpen_strongFoco muito perdido
sharpen_naturalNitidez suave que preserva a textura orgânica
sharpen_portraitRostos e pele
sharpen_wildlifePelo, penas e outros detalhes naturais
sharpen_refocusDetalhes finos em uma foto levemente desfocada
sharpen_motion_blurBorrão causado pelo movimento da câmera ou do assunto
sharpen_lens_blurDesfoque 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âmetroObrigatórioDescrição
image_urlSimA imagem de partida.
output_formatNãoTipo de arquivo do resultado. jpeg · png · Padrão: jpeg
presetNãoEscolha 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çãoUSD por imagem
PadrãoUS$ 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

  1. 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.
  2. 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.
  3. 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.

Mais sobre o Topaz Denoise & Sharpen