Introdução
O que este endpoint faz
Ele roda um modelo da Topaz Labs em uma foto. Os presets de denoise eliminam grão, ruído de ISO alto e pontinhos de compressão; os presets de nitidez corrigem foco suave, tremido e desfoque da lente. A saída tem a mesma largura e altura da entrada.
Entradas que importam
image_url aceita um JPEG, PNG ou WebP de até 24 megapixels, enviado ou como link público. preset escolhe o modelo e o padrão é denoise_normal. output_format é jpeg (padrão) ou png.
O que você recebe
Uma imagem por solicitação, entregue pelo armazenamento da plataforma quando a tarefa assíncrona termina. Imagens acima de 24 megapixels são recusadas no envio com invalid_request.
| Campo | Valor |
|---|---|
| Entrada | Imagem |
| Saída | Imagem |
| Endpoint | Edição de imagem |
| Presets | 3 níveis de denoise, 8 modelos de nitidez |
| Prompt | Nenhum |
| Cobrança | Preço fixo por imagem |
Recursos e destaques
Foto de bar à luz de velas, sem pontinhos e com o rosto preservado
Cobrimos um retrato de 2048×1152 com ruído de cor pesado e passamos pelo Denoise Normal. Os pontinhos no suéter e nas prateleiras escuras de vinho sumiram, enquanto os olhos, a argola e as luzes do bokeh ficaram no lugar. As sardas voltaram mais claras do que no original limpo.
Grão de filme removido de um retrato no café
Um WebP de 1024×1536 com grão cinza fino sobre pele, cabelo e um suéter de tricô passou pelo Denoise Strong em cerca de 25 segundos. O grão sumiu, os cachos mantiveram as mechas e o suéter o ponto do tricô; a pele saiu um pouco mais lisa.
Sharpen Standard devolve o foco a um rosto suave
Um retrato que desfocamos de propósito voltou com olhos, sobrancelhas e barba rala legíveis em 14 segundos. Esse detalhe é reconstruído pelo modelo, então confira o resultado em tamanho real antes de confiar nele.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
image_url | Sim | A foto a limpar: JPEG, PNG ou WebP enviado ou por link público, com no máximo 24 megapixels (6000×4000 cabe). Imagens maiores são recusadas no envio, sem cobrança. pelo menos 1 caracteres |
preset | Não | Qual modelo da Topaz roda. |
output_format | Não | jpeg (padrão) ou png. png evita mais uma rodada de compressão com perda e gera um arquivo maior. |
Preços
$0.12 / imagem
Cada imagem concluída custa o mesmo valor fixo, seja qual for o preset entre os onze ou o formato de saída entre os dois; uma solicitação com falha ou recusada não custa nada.
Casos de uso
Fotos de celular à noite e em ambientes internos
Imagens com ISO alto de shows, restaurantes ou uma sala escura ficam manchadas. Comece pelo Denoise Normal e suba para o Strong se as sombras continuarem pontilhadas.
Granulação em imagens geradas por IA
Alguns modelos de imagem deixam um grão fino ou uma textura repetida na pele e em fundos lisos. Uma passada do Denoise entrega uma base mais limpa antes de ampliar, recortar ou imprimir.
Fotos quase em foco
Um foco levemente errado, um pouco de tremido ou uma lente mole. Sharpen Standard resolve os casos leves, Motion Blur e Lens Blur miram esses dois problemas, e Portrait ou Wildlife são ajustados para pele e pelagem.
Guia de prompt e dicas práticas
Confira o tamanho
Envie um JPEG, PNG ou WebP de até 24 megapixels, como upload ou link público. Arquivos maiores são recusados no envio, então reduza antes.
Escolha um preset
Use um preset denoise_ quando o problema for grão ou pontinhos e um preset sharpen_ quando for desfoque. Cada solicitação roda um único preset; se precisar dos dois, tire o ruído primeiro e mande esse resultado para o Sharpen.
Consulte e compare
Crie a tarefa, consulte até terminar e baixe o arquivo do armazenamento da plataforma. Compare com a original em 100% de zoom nos olhos, no cabelo e nas texturas finas.
Introdução
Topaz Denoise & Sharpen reúne duas famílias de modelos da Topaz Labs em um só endpoint. Denoise remove ruído e grão tentando manter o detalhe real; Sharpen recupera a nitidez perdida por erro de foco, movimento ou lente mole. O modelo é escolhido com preset; não há prompt.
Solicitação
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}
Presets
| preset | Use para |
|---|---|
denoise_normal | Ruído do dia a dia por pouca luz ou compressão (padrão) |
denoise_strong | Fotos muito escuras ou com ISO alto; preserva mais detalhe que o Extreme |
denoise_extreme | Imagens muito degradadas ou bastante comprimidas |
sharpen_standard | Leve falta de nitidez ou pouco tremido; o ponto de partida habitual |
sharpen_strong | Foco claramente perdido |
sharpen_natural | Nitidez contida que respeita texturas orgânicas |
sharpen_portrait | Rostos e pele |
sharpen_wildlife | Pelagem, penas e outros detalhes da natureza |
sharpen_refocus | Detalhe fino em uma imagem um pouco fora de foco |
sharpen_motion_blur | Desfoque por movimento da câmera ou do tema |
sharpen_lens_blur | Desfoque e lente mole |
Nossos testes
Um retrato à luz de velas de 2048×1152 com muito ruído de cor adicionado voltou limpo em cerca de 19 segundos com denoise_normal; olhos, brincos e luzes do bokeh resistiram, e as sardas ficaram mais fracas. Um retrato de café de 1024×1536 com grão fino, enviado como WebP, perdeu o grão com denoise_strong em cerca de 25 segundos, mantendo os cachos e o tricô do suéter. Um retrato de 1100×900 desfocado de propósito recuperou olhos e barba com sharpen_standard em 14 segundos. Os três voltaram no tamanho de entrada.
Limites
As entradas têm teto de 24 megapixels (6000×4000 cabe); imagens maiores são recusadas antes de qualquer cobrança. Denoise e Sharpen são solicitações separadas, então encadeie as duas se uma imagem precisar de ambas. A nitidez reconstrói detalhes, por isso confira rostos e texto em tamanho real.
Início rápido da 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"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
