Files
SnapOtter/apps/docs/pt-BR/tools/image/rotate.md
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.4 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Gire imagens em qualquer ângulo e espelhe na horizontal ou na vertical. c4ed5f7e270b human 064aa90129d1

Girar e Espelhar Imagem

Gire imagens em um ângulo arbitrário e/ou espelhe-as na horizontal ou na vertical. As operações de rotação e espelhamento podem ser combinadas em uma única requisição.

Endpoint da API

POST /api/v1/tools/image/rotate

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
angle number Não 0 Ângulo de rotação em graus (sentido horário). Aceita qualquer valor numérico.
horizontal boolean Não false Espelhar a imagem na horizontal (espelho)
vertical boolean Não false Espelhar a imagem na vertical

Exemplo de Requisição

Girar 90 graus no sentido horário:

curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"angle": 90}'

Espelhar na horizontal:

curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"horizontal": true}'

Girar e espelhar juntos:

curl -X POST http://localhost:1349/api/v1/tools/image/rotate \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@photo.jpg" \
  -F 'settings={"angle": 45, "vertical": true}'

Exemplo de Resposta

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

Notas

  • A rotação é aplicada primeiro, depois as operações de espelhamento.
  • Rotações que não são de 90 graus (por exemplo, 45 graus) ampliarão a tela para acomodar a imagem girada, com preenchimento transparente ou preto dependendo do formato de saída.
  • Valores comuns: 90, 180, 270 para rotações de um quarto de volta.
  • A orientação EXIF é aplicada automaticamente antes do processamento, então a rotação é relativa à orientação visual.