mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

3.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Corrige PNGs com transparência falsa usando matting por IA (BiRefNet) para produzir alfa verdadeiro, além de limpeza de bordas com defringe.	7eb748b80f93	human	0177d4566d1e

Corretor de Transparência de PNG

Corrige PNGs com transparência falsa em um clique. Usa matting por IA (modelo BiRefNet HR Matting) para produzir transparência alfa verdadeira, com pós-processamento de defringe para limpar as bordas.

Endpoint da API

POST /api/v1/tools/image/transparency-fixer

Processamento: Assíncrono (retorna 202, consulte /api/v1/jobs/{jobId}/progress para obter o status via SSE)

Pacote de modelo: background-removal (4-5 GB)

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
file	file	Sim	-	Arquivo de imagem (multipart)
defringe	number	Não	`30`	Intensidade de defringe (0-100). Remove pixels de franja semitransparentes ao redor das bordas
outputFormat	string	Não	`"png"`	Formato de saída: `png` ou `webp`
removeWatermark	boolean	Não	`false`	Aplica pré-processamento de remoção de marca d'água (filtro de mediana)

Exemplo de Requisição

curl -X POST http://localhost:1349/api/v1/tools/image/transparency-fixer \
  -F "file=@fake-transparent.png" \
  -F 'settings={"defringe":40,"outputFormat":"png"}'

Resposta

Resposta Inicial (202 Accepted)

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Progresso (SSE em `/api/v1/jobs/{jobId}/progress`)

event: progress
data: {"phase":"processing","stage":"Processing transparency...","percent":50}

Resultado Final (via SSE)

{
  "phase": "complete",
  "percent": 100,
  "result": {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "downloadUrl": "/api/v1/download/{jobId}/fake-transparent_fixed.png",
    "originalSize": 180000,
    "processedSize": 150000,
    "filename": "fake-transparent.png"
  }
}

Notas

Requer que o pacote de modelo background-removal esteja instalado (4-5 GB).
Usa birefnet-hr-matting como modelo principal para matting alfa de alta qualidade. Recai para birefnet-general se o modelo HR ficar sem memória.
A opção defringe remove pixels de franja semitransparentes que o matting por IA às vezes deixa ao redor de cabelos, pelos e bordas finas. Ela funciona desfocando o canal alfa e zerando pixels de baixa confiança.
A opção removeWatermark aplica uma etapa de pré-processamento com filtro de mediana. É uma redução básica de marca d'água, não uma ferramenta dedicada de remoção de marca d'água.
Produz apenas PNG ou WebP sem perdas (ambos suportam transparência alfa).
Suporta os formatos de entrada HEIC/HEIF, RAW, TGA, PSD, EXR e HDR via decodificação automática.

3.1 KiB Raw Blame History