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

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Recorte imagens especificando uma região com posição e dimensões.	556f37893553	human	710ea29989d0

Recortar Imagem

Recorte imagens definindo uma região retangular usando posição e tamanho. Suporta unidades tanto em pixels quanto em porcentagem.

Endpoint da API

POST /api/v1/tools/image/crop

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
left	number	Sim	-	Deslocamento X da região de recorte (a partir da borda esquerda)
top	number	Sim	-	Deslocamento Y da região de recorte (a partir da borda superior)
width	number	Sim	-	Largura da região de recorte
height	number	Sim	-	Altura da região de recorte
unit	string	Não	`"px"`	Unidade para os valores: `px` ou `percent`

Exemplo de Requisição

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

Recortar usando valores em porcentagem:

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

Exemplo de Resposta

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

Notas

A região de recorte deve caber dentro dos limites da imagem. Se a região se estender além da imagem, a requisição falhará.
Ao usar a unidade percent, os valores representam porcentagens das dimensões da imagem (por exemplo, left: 10 significa 10% a partir da borda esquerda).
O formato de saída corresponde ao formato de entrada.
A orientação EXIF é aplicada automaticamente antes do recorte, então as coordenadas correspondem à orientação visualmente correta.

2.3 KiB Raw Blame History