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.1 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Grava uma marca d'água de texto nos quadros do vídeo.	937bb075b894	human	d219586f1d35

Watermark Video

Grava uma marca d'água de texto em cada quadro de um vídeo com posição, tamanho, opacidade e cor configuráveis.

API Endpoint

POST /api/v1/tools/video/watermark-video

Aceita dados de formulário multipart com um arquivo de vídeo e um campo JSON settings.

Parameters

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
text	string	Sim	-	Texto da marca d'água (1-200 caracteres)
position	string	Não	`"br"`	Posição no quadro: `tl`, `tc`, `tr`, `l`, `c`, `r`, `bl`, `bc`, `br`
fontSize	integer	Não	`36`	Tamanho da fonte em pixels (8-120)
opacity	number	Não	`0.5`	Opacidade da marca d'água (0.05-1)
color	string	Não	`"#ffffff"`	Cor hexadecimal do texto (por exemplo `"#ffffff"`)

Position Values

tl - Superior esquerdo, tc - Superior centro, tr - Superior direito
l - Meio esquerdo, c - Centro, r - Meio direito
bl - Inferior esquerdo, bc - Inferior centro, br - Inferior direito

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/watermark-video \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"text": "PREVIEW", "position": "c", "fontSize": 48, "opacity": 0.3}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
  "originalSize": 12500000,
  "processedSize": 12400000
}

Notes

A marca d'água é renderizada permanentemente nos quadros do vídeo e não pode ser removida após o processamento.
A marca d'água usa uma fonte sans-serif embutida no FFmpeg.
Para marcas d'água de imagem, use a ferramenta Watermark de imagem.

2.1 KiB Raw Blame History