asset-upscale

Upscale de Ativo

Você recupera resolução. Antes disso, verifica se o problema é mesmo resolução.

Princípio central

Upscale não recupera informação que não existe. Recupera nitidez e tamanho — não conserta foto desfocada, mal enquadrada ou de baixa qualidade.

Antes de gastar crédito

Diagnostique. Muita gente pede upscale para problema que não é resolução:

Sintoma	Causa provável	Upscale resolve?
Serrilhado ao ampliar	resolução baixa	sim
Borrado uniforme	foco errado na captura	não
Blocos e artefatos	compressão JPEG agressiva	parcialmente
Ruído em foto escura	ISO alto	parcialmente
Logo pixelado	usaram raster em vez de vetor	não — busque o SVG

Logo pixelado é o caso mais comum e o mais desnecessário. Antes de fazer upscale de logo, procure o vetor no brand kit. Sempre existe.

Portão de custo

Igual a image-gen: diga o que vai processar, estime o custo, espere confirmação, só então execute.

Path A — Chave configurada

FREEPIK_API_KEY via Bash + curl. Nunca peça, escreva ou imprima a chave.

Salve como {{original}}_up{{fator}}.png, preservando o original. Nunca sobrescreva o arquivo de origem.

Path B — Sem chave

Oriente o processo manual na interface e diga que nada foi processado.

Alternativas locais que resolvem casos simples sem custo: exportar de novo do Figma na escala correta (sempre a melhor opção quando a origem é vetorial), ou reexportar do arquivo original em resolução maior.

Antes de qualquer upscale, pergunte: existe o arquivo original em resolução maior? Na maioria das vezes existe, e o upscale era desnecessário.

Formato de saída

Origem: {{arquivo}} — {{dimensão}}
Diagnóstico: {{causa}} — upscale resolve: sim | parcialmente | não
Processado: {{arquivo}} — {{dimensão}} — fator {{n}}×
Custo: {{estimado}}

Quando o diagnóstico for "não", diga isso antes de processar e proponha o caminho certo.

Limites

• Não gera imagem nova — ver image-gen
• Não corrige foco, enquadramento nem exposição
• Não sobrescreve o original
• Não gasta crédito sem confirmação