Files
SnapOtter/apps/docs/ru/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

3.2 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Поворот изображений на любой угол и отражение по горизонтали или вертикали. c4ed5f7e270b human 8b48a012ca5a

Поворот и отражение изображения

Поворот изображений на произвольный угол и/или их отражение по горизонтали или вертикали. Операции поворота и отражения можно объединить в одном запросе.

Эндпоинт API

POST /api/v1/tools/image/rotate

Принимает multipart form data с файлом изображения и JSON-полем settings.

Параметры

Параметр Тип Обязательный По умолчанию Описание
angle number Нет 0 Угол поворота в градусах (по часовой стрелке). Принимает любое числовое значение.
horizontal boolean Нет false Отразить изображение по горизонтали (зеркально)
vertical boolean Нет false Отразить изображение по вертикали

Пример запроса

Поворот на 90 градусов по часовой стрелке:

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

Отражение по горизонтали:

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

Поворот и отражение вместе:

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

Пример ответа

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

Примечания

  • Сначала применяется поворот, затем операции отражения.
  • Повороты не на 90 градусов (например, 45 градусов) увеличат холст, чтобы вместить повёрнутое изображение, с прозрачной или чёрной заливкой в зависимости от выходного формата.
  • Обычные значения: 90, 180, 270 для поворотов на четверть оборота.
  • Ориентация по EXIF применяется автоматически перед обработкой, поэтому поворот отсчитывается относительно визуальной ориентации.