# Asset Upscale

> Aumenta a resolução e nitidez de imagens via API Freepik/Magnific quando uma chave está configurada, ou orienta o processo manual e alternativas locais quando não há chave, sempre exigindo confirmação antes de gastar crédito.

- Skill: `pwdev-solucoes/asset-upscale` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pwdev-solucoes/asset-upscale`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pwdev-solucoes/asset-upscale/raw
- Safety review: CAUTION (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media, Coding & Dev Tools, Illustration & Graphics
- Tags: Freepik, Image Enhancement, Image Processing, Image Resolution, Magnific, Upscale
- Author: pwdev-solucoes (https://skillmd.com/u/pwdev-solucoes)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/pwdev-solucoes/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

## Skills relacionadas

- `image-gen` — origem dos ativos gerados
- `export-handoff` — export em escala correta costuma dispensar upscale