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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Vul een afbeelding op tot een doelbeeldverhouding met een effen kleur, transparante of vervaagde achtergrond.	796122da3dae	human	6cc7c1b428f3

Afbeelding opvullen

Vul een afbeelding op tot een doelbeeldverhouding door er een effen kleur, transparante of vervaagde achtergrond omheen toe te voegen. Handig om afbeeldingen in vaste beeldverhoudingen te passen voor sociale media of print zonder bij te snijden.

API Endpoint

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

Accepteert multipart-formuliergegevens met een afbeeldingsbestand en een JSON-veld settings.

Parameters

Parameter	Type	Vereist	Standaard	Beschrijving
target	string	Nee	`"1:1"`	Doelbeeldverhouding: `16:9`, `9:16`, `1:1`, `4:3`, `3:4` of `custom`
ratioW	integer	Nee	`1`	Aangepaste verhoudingsbreedte (1-100, gebruikt wanneer target `custom` is)
ratioH	integer	Nee	`1`	Aangepaste verhoudingshoogte (1-100, gebruikt wanneer target `custom` is)
background	string	Nee	`"color"`	Achtergrondmodus: `color`, `transparent` of `blur`
color	string	Nee	`"#ffffff"`	Achtergrondkleur in hex (wanneer background `color` is)
padding	integer	Nee	`0`	Extra padding als percentage van het canvas (0-50)

Voorbeeldverzoek

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}'

Voorbeeldantwoord

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

Opmerkingen

De achtergrondmodus blur maakt een vervaagde kopie van de oorspronkelijke afbeelding als opvulling, wat een visueel samenhangend resultaat oplevert.
Bij gebruik van de achtergrond transparent wordt de uitvoer geconverteerd naar PNG om het alfakanaal te behouden.
Het uitvoerformaat komt overeen met het invoerformaat, tenzij er transparantie in het spel is. HEIC-, RAW-, PSD- en SVG-invoer wordt automatisch gedecodeerd vóór de verwerking.
Stel target in op custom en geef ratioW en ratioH op voor willekeurige beeldverhoudingen (bijv. ratioW: 3, ratioH: 2 voor 3:2).

2.5 KiB Raw Blame History