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

2.4 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Preencha uma imagem até uma proporção alvo com um fundo de cor sólida, transparente ou desfocado.	796122da3dae	human	74b1a079453c

Preencher Imagem

Preencha uma imagem até uma proporção alvo adicionando um fundo de cor sólida, transparente ou desfocado ao seu redor. Útil para ajustar imagens a proporções fixas para redes sociais ou impressão sem recortar.

Endpoint da API

POST /api/v1/tools/image/image-pad

Aceita dados de formulário multipart com um arquivo de imagem e um campo JSON settings.

Parâmetros

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
target	string	Não	`"1:1"`	Proporção alvo: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` ou `custom`
ratioW	integer	Não	`1`	Largura da proporção personalizada (1-100, usada quando target é `custom`)
ratioH	integer	Não	`1`	Altura da proporção personalizada (1-100, usada quando target é `custom`)
background	string	Não	`"color"`	Modo de fundo: `color`, `transparent` ou `blur`
color	string	Não	`"#ffffff"`	Cor hexadecimal de fundo (quando background é `color`)
padding	integer	Não	`0`	Preenchimento extra como percentual da tela (0-50)

Exemplo de Requisição

curl -X POST http://localhost:1349/api/v1/tools/image/image-pad \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"target": "16:9", "background": "blur", "padding": 5}'

Exemplo de Resposta

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
  "originalSize": 2450000,
  "processedSize": 3100000
}

Observações

O modo de fundo blur cria uma cópia desfocada da imagem original como preenchimento, produzindo um resultado visualmente coeso.
Ao usar o fundo transparent, a saída é convertida para PNG para preservar o canal alfa.
O formato de saída corresponde ao formato de entrada, a menos que haja transparência envolvida. Entradas HEIC, RAW, PSD e SVG são decodificadas automaticamente antes do processamento.
Defina target como custom e forneça ratioW e ratioH para proporções arbitrárias (por exemplo, ratioW: 3, ratioH: 2 para 3:2).

2.4 KiB Raw Blame History