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

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.

2026-07-15 21:55:51 +08:00

2.2 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Beskär bilder genom att ange ett område med position och dimensioner.	556f37893553	human	37bd3b1a4f17

Beskär bild

Beskär bilder genom att definiera ett rektangulärt område med hjälp av position och storlek. Stöder både pixel- och procentenheter.

API-slutpunkt

POST /api/v1/tools/image/crop

Tar emot multipart-formulärdata med en bildfil och ett JSON-fält settings.

Parametrar

Parameter	Typ	Obligatorisk	Standard	Beskrivning
left	number	Ja	-	X-förskjutning för beskärningsområdet (från vänsterkanten)
top	number	Ja	-	Y-förskjutning för beskärningsområdet (från överkanten)
width	number	Ja	-	Bredd på beskärningsområdet
height	number	Ja	-	Höjd på beskärningsområdet
unit	string	Nej	`"px"`	Enhet för värdena: `px` eller `percent`

Exempelbegäran

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 100, "top": 50, "width": 800, "height": 600}'

Beskär med procentvärden:

curl -X POST http://localhost:1349/api/v1/tools/image/crop \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"left": 10, "top": 10, "width": 80, "height": 80, "unit": "percent"}'

Exempelsvar

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

Anteckningar

Beskärningsområdet måste rymmas inom bildens gränser. Om området sträcker sig utanför bilden misslyckas begäran.
När enheten percent används representerar värdena procent av bildens dimensioner (t.ex. innebär left: 10 10 % från vänsterkanten).
Utdataformatet matchar indataformatet.
EXIF-orientering tillämpas automatiskt före beskärning, så koordinaterna motsvarar den visuellt korrekta orienteringen.

2.2 KiB Raw Blame History