mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
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.
131 lines
13 KiB
Markdown
131 lines
13 KiB
Markdown
---
|
||
description: "Выделенные эндпоинты пресетов конвертации, сгенерированные из каталога инструментов SnapOtter."
|
||
i18n_source_hash: faad6efcb9a9
|
||
i18n_provenance: human
|
||
i18n_output_hash: d883364d8033
|
||
---
|
||
|
||
# Пресеты конвертации {#conversion-presets}
|
||
|
||
SnapOtter предоставляет 83 выделенных эндпоинта пресетов конвертации в дополнение к базовым инструментам-конвертерам. Каждый пресет фиксирует выходной формат и делегирует обработку своему базовому конвейеру, поэтому поведение, валидация и контракт вывода совпадают с базовым инструментом, указанным ниже.
|
||
|
||
## Шаблон эндпоинта API {#api-endpoint-pattern}
|
||
|
||
`POST /api/v1/tools/<section>/<presetId>`
|
||
|
||
Отправьте `multipart/form-data` с частью `file` и необязательной JSON-строкой `settings`. Пресеты следуют контракту ответа базового инструмента. Быстрые пресеты обычно возвращают `200` с `downloadUrl`, но могут вернуть `202`, если превышают окно синхронного ожидания. Видеопресеты и длительные пресеты файлов/документов возвращают `202` и потоки прогресса из `/api/v1/jobs/<jobId>/progress`. Пресеты PDF-в-изображение возвращают URL для скачивания страниц плюс URL ZIP-архива.
|
||
|
||
## Пресеты изображений {#image-presets}
|
||
|
||
| ID пресета | Конвертирует | Маршрут | Базовый инструмент | Принимаемые входы | Необязательные настройки |
|
||
|-----------|----------|-------|-----------|-----------------|-------------------|
|
||
| `jpg-to-png` | JPG в PNG | `/api/v1/tools/image/jpg-to-png` | `convert` | `.jpg`, `.jpeg` | quality |
|
||
| `png-to-jpg` | PNG в JPG | `/api/v1/tools/image/png-to-jpg` | `convert` | `.png` | quality |
|
||
| `jpg-to-webp` | JPG в WebP | `/api/v1/tools/image/jpg-to-webp` | `convert` | `.jpg`, `.jpeg` | quality |
|
||
| `png-to-webp` | PNG в WebP | `/api/v1/tools/image/png-to-webp` | `convert` | `.png` | quality |
|
||
| `webp-to-jpg` | WebP в JPG | `/api/v1/tools/image/webp-to-jpg` | `convert` | `.webp` | quality |
|
||
| `webp-to-png` | WebP в PNG | `/api/v1/tools/image/webp-to-png` | `convert` | `.webp` | quality |
|
||
| `jpg-to-avif` | JPG в AVIF | `/api/v1/tools/image/jpg-to-avif` | `convert` | `.jpg`, `.jpeg` | quality |
|
||
| `png-to-avif` | PNG в AVIF | `/api/v1/tools/image/png-to-avif` | `convert` | `.png` | quality |
|
||
| `webp-to-avif` | WebP в AVIF | `/api/v1/tools/image/webp-to-avif` | `convert` | `.webp` | quality |
|
||
| `heic-to-jpg` | HEIC в JPG | `/api/v1/tools/image/heic-to-jpg` | `convert` | `.heic`, `.heif` | quality |
|
||
| `heic-to-png` | HEIC в PNG | `/api/v1/tools/image/heic-to-png` | `convert` | `.heic`, `.heif` | quality |
|
||
| `heic-to-avif` | HEIC в AVIF | `/api/v1/tools/image/heic-to-avif` | `convert` | `.heic`, `.heif` | quality |
|
||
| `jpg-to-gif` | JPG в GIF | `/api/v1/tools/image/jpg-to-gif` | `convert` | `.jpg`, `.jpeg` | quality |
|
||
| `png-to-gif` | PNG в GIF | `/api/v1/tools/image/png-to-gif` | `convert` | `.png` | quality |
|
||
| `gif-to-jpg` | GIF в JPG | `/api/v1/tools/image/gif-to-jpg` | `convert` | `.gif` | quality |
|
||
| `gif-to-png` | GIF в PNG | `/api/v1/tools/image/gif-to-png` | `convert` | `.gif` | quality |
|
||
| `webp-to-gif` | WebP в GIF | `/api/v1/tools/image/webp-to-gif` | `convert` | `.webp` | quality |
|
||
| `jpg-to-tiff` | JPG в TIFF | `/api/v1/tools/image/jpg-to-tiff` | `convert` | `.jpg`, `.jpeg` | quality |
|
||
| `png-to-tiff` | PNG в TIFF | `/api/v1/tools/image/png-to-tiff` | `convert` | `.png` | quality |
|
||
| `tiff-to-jpg` | TIFF в JPG | `/api/v1/tools/image/tiff-to-jpg` | `convert` | `.tiff`, `.tif` | quality |
|
||
| `tiff-to-png` | TIFF в PNG | `/api/v1/tools/image/tiff-to-png` | `convert` | `.tiff`, `.tif` | quality |
|
||
| `psd-to-jpg` | PSD в JPG | `/api/v1/tools/image/psd-to-jpg` | `convert` | `.psd` | quality |
|
||
| `psd-to-png` | PSD в PNG | `/api/v1/tools/image/psd-to-png` | `convert` | `.psd` | quality |
|
||
| `png-to-eps` | PNG в EPS | `/api/v1/tools/image/png-to-eps` | `convert` | `.png` | quality |
|
||
| `jpg-to-eps` | JPG в EPS | `/api/v1/tools/image/jpg-to-eps` | `convert` | `.jpg`, `.jpeg` | quality |
|
||
| `eps-to-png` | EPS в PNG | `/api/v1/tools/image/eps-to-png` | `convert` | `.eps` | quality |
|
||
| `eps-to-jpg` | EPS в JPG | `/api/v1/tools/image/eps-to-jpg` | `convert` | `.eps` | quality |
|
||
| `png-to-svg` | PNG в SVG | `/api/v1/tools/image/png-to-svg` | `vectorize` | `.png` | none |
|
||
| `jpg-to-svg` | JPG в SVG | `/api/v1/tools/image/jpg-to-svg` | `vectorize` | `.jpg`, `.jpeg` | none |
|
||
| `tiff-to-svg` | TIFF в SVG | `/api/v1/tools/image/tiff-to-svg` | `vectorize` | `.tiff`, `.tif` | none |
|
||
| `psd-to-svg` | PSD в SVG | `/api/v1/tools/image/psd-to-svg` | `vectorize` | `.psd` | none |
|
||
| `eps-to-svg` | EPS в SVG | `/api/v1/tools/image/eps-to-svg` | `vectorize` | `.eps` | none |
|
||
| `svg-to-png` | SVG в PNG | `/api/v1/tools/image/svg-to-png` | `svg-to-raster` | `.svg`, `.svgz` | quality, width, height, dpi, backgroundColor |
|
||
| `svg-to-jpg` | SVG в JPG | `/api/v1/tools/image/svg-to-jpg` | `svg-to-raster` | `.svg`, `.svgz` | quality, width, height, dpi, backgroundColor |
|
||
| `jpg-to-pdf` | JPG в PDF | `/api/v1/tools/image/jpg-to-pdf` | `image-to-pdf` | `.jpg`, `.jpeg` | pageSize, orientation, margin, targetSize, collate |
|
||
| `png-to-pdf` | PNG в PDF | `/api/v1/tools/image/png-to-pdf` | `image-to-pdf` | `.png` | pageSize, orientation, margin, targetSize, collate |
|
||
| `heic-to-pdf` | HEIC в PDF | `/api/v1/tools/image/heic-to-pdf` | `image-to-pdf` | `.heic`, `.heif` | pageSize, orientation, margin, targetSize, collate |
|
||
| `tiff-to-pdf` | TIFF в PDF | `/api/v1/tools/image/tiff-to-pdf` | `image-to-pdf` | `.tiff`, `.tif` | pageSize, orientation, margin, targetSize, collate |
|
||
| `webp-to-pdf` | WebP в PDF | `/api/v1/tools/image/webp-to-pdf` | `image-to-pdf` | `.webp` | pageSize, orientation, margin, targetSize, collate |
|
||
| `gif-to-pdf` | GIF в PDF | `/api/v1/tools/image/gif-to-pdf` | `image-to-pdf` | `.gif` | pageSize, orientation, margin, targetSize, collate |
|
||
| `eps-to-pdf` | EPS в PDF | `/api/v1/tools/image/eps-to-pdf` | `image-to-pdf` | `.eps` | pageSize, orientation, margin, targetSize, collate |
|
||
|
||
## Видеопресеты {#video-presets}
|
||
|
||
| ID пресета | Конвертирует | Маршрут | Базовый инструмент | Принимаемые входы | Необязательные настройки |
|
||
|-----------|----------|-------|-----------|-----------------|-------------------|
|
||
| `mov-to-mp4` | MOV в MP4 | `/api/v1/tools/video/mov-to-mp4` | `convert-video` | `.mov` | quality |
|
||
| `webm-to-mp4` | WEBM в MP4 | `/api/v1/tools/video/webm-to-mp4` | `convert-video` | `.webm` | quality |
|
||
| `mkv-to-mp4` | MKV в MP4 | `/api/v1/tools/video/mkv-to-mp4` | `convert-video` | `.mkv` | quality |
|
||
| `avi-to-mp4` | AVI в MP4 | `/api/v1/tools/video/avi-to-mp4` | `convert-video` | `.avi` | quality |
|
||
| `mp4-to-mov` | MP4 в MOV | `/api/v1/tools/video/mp4-to-mov` | `convert-video` | `.mp4` | quality |
|
||
| `mp4-to-webm` | MP4 в WEBM | `/api/v1/tools/video/mp4-to-webm` | `convert-video` | `.mp4` | quality |
|
||
| `webm-to-mov` | WEBM в MOV | `/api/v1/tools/video/webm-to-mov` | `convert-video` | `.webm` | quality |
|
||
| `mkv-to-mov` | MKV в MOV | `/api/v1/tools/video/mkv-to-mov` | `convert-video` | `.mkv` | quality |
|
||
| `avi-to-mov` | AVI в MOV | `/api/v1/tools/video/avi-to-mov` | `convert-video` | `.avi` | quality |
|
||
| `mp4-to-avi` | MP4 в AVI | `/api/v1/tools/video/mp4-to-avi` | `convert-video` | `.mp4` | quality |
|
||
| `mov-to-avi` | MOV в AVI | `/api/v1/tools/video/mov-to-avi` | `convert-video` | `.mov` | quality |
|
||
| `mkv-to-avi` | MKV в AVI | `/api/v1/tools/video/mkv-to-avi` | `convert-video` | `.mkv` | quality |
|
||
| `avi-to-mkv` | AVI в MKV | `/api/v1/tools/video/avi-to-mkv` | `convert-video` | `.avi` | quality |
|
||
| `mp4-to-gif` | MP4 в GIF | `/api/v1/tools/video/mp4-to-gif` | `video-to-gif` | `.mp4` | fps, width, startS, durationS |
|
||
| `mov-to-gif` | MOV в GIF | `/api/v1/tools/video/mov-to-gif` | `video-to-gif` | `.mov` | fps, width, startS, durationS |
|
||
| `mkv-to-gif` | MKV в GIF | `/api/v1/tools/video/mkv-to-gif` | `video-to-gif` | `.mkv` | fps, width, startS, durationS |
|
||
| `avi-to-gif` | AVI в GIF | `/api/v1/tools/video/avi-to-gif` | `video-to-gif` | `.avi` | fps, width, startS, durationS |
|
||
| `gif-to-mp4` | GIF в MP4 | `/api/v1/tools/video/gif-to-mp4` | `gif-to-video` | `.gif` | none |
|
||
| `gif-to-webm` | GIF в WEBM | `/api/v1/tools/video/gif-to-webm` | `gif-to-video` | `.gif` | none |
|
||
| `gif-to-mov` | GIF в MOV | `/api/v1/tools/video/gif-to-mov` | `gif-to-video` | `.gif` | none |
|
||
| `mp4-to-mp3` | MP4 в MP3 | `/api/v1/tools/video/mp4-to-mp3` | `extract-audio` | `.mp4` | none |
|
||
| `mov-to-mp3` | MOV в MP3 | `/api/v1/tools/video/mov-to-mp3` | `extract-audio` | `.mov` | none |
|
||
| `mkv-to-mp3` | MKV в MP3 | `/api/v1/tools/video/mkv-to-mp3` | `extract-audio` | `.mkv` | none |
|
||
| `webm-to-mp3` | WEBM в MP3 | `/api/v1/tools/video/webm-to-mp3` | `extract-audio` | `.webm` | none |
|
||
| `avi-to-mp3` | AVI в MP3 | `/api/v1/tools/video/avi-to-mp3` | `extract-audio` | `.avi` | none |
|
||
| `mp4-to-wav` | MP4 в WAV | `/api/v1/tools/video/mp4-to-wav` | `extract-audio` | `.mp4` | none |
|
||
| `mov-to-wav` | MOV в WAV | `/api/v1/tools/video/mov-to-wav` | `extract-audio` | `.mov` | none |
|
||
| `mp4-to-ogg` | MP4 в OGG | `/api/v1/tools/video/mp4-to-ogg` | `extract-audio` | `.mp4` | none |
|
||
|
||
## Аудиопресеты {#audio-presets}
|
||
|
||
| ID пресета | Конвертирует | Маршрут | Базовый инструмент | Принимаемые входы | Необязательные настройки |
|
||
|-----------|----------|-------|-----------|-----------------|-------------------|
|
||
| `m4a-to-mp3` | M4A в MP3 | `/api/v1/tools/audio/m4a-to-mp3` | `convert-audio` | `.m4a` | none |
|
||
| `m4a-to-wav` | M4A в WAV | `/api/v1/tools/audio/m4a-to-wav` | `convert-audio` | `.m4a` | none |
|
||
| `aac-to-mp3` | AAC в MP3 | `/api/v1/tools/audio/aac-to-mp3` | `convert-audio` | `.aac` | none |
|
||
| `aac-to-wav` | AAC в WAV | `/api/v1/tools/audio/aac-to-wav` | `convert-audio` | `.aac` | none |
|
||
| `aac-to-flac` | AAC в FLAC | `/api/v1/tools/audio/aac-to-flac` | `convert-audio` | `.aac` | none |
|
||
| `ogg-to-mp3` | OGG в MP3 | `/api/v1/tools/audio/ogg-to-mp3` | `convert-audio` | `.ogg` | none |
|
||
| `ogg-to-wav` | OGG в WAV | `/api/v1/tools/audio/ogg-to-wav` | `convert-audio` | `.ogg` | none |
|
||
| `wav-to-mp3` | WAV в MP3 | `/api/v1/tools/audio/wav-to-mp3` | `convert-audio` | `.wav` | none |
|
||
| `mp3-to-wav` | MP3 в WAV | `/api/v1/tools/audio/mp3-to-wav` | `convert-audio` | `.mp3` | none |
|
||
| `flac-to-mp3` | FLAC в MP3 | `/api/v1/tools/audio/flac-to-mp3` | `convert-audio` | `.flac` | none |
|
||
|
||
## Пресеты PDF {#pdf-presets}
|
||
|
||
| ID пресета | Конвертирует | Маршрут | Базовый инструмент | Принимаемые входы | Необязательные настройки |
|
||
|-----------|----------|-------|-----------|-----------------|-------------------|
|
||
| `pdf-to-jpg` | PDF в JPG | `/api/v1/tools/pdf/pdf-to-jpg` | `pdf-to-image` | `.pdf` | dpi, quality, colorMode, pages |
|
||
| `pdf-to-png` | PDF в PNG | `/api/v1/tools/pdf/pdf-to-png` | `pdf-to-image` | `.pdf` | dpi, quality, colorMode, pages |
|
||
| `pdf-to-tiff` | PDF в TIFF | `/api/v1/tools/pdf/pdf-to-tiff` | `pdf-to-image` | `.pdf` | dpi, quality, colorMode, pages |
|
||
|
||
## Пресеты файлов {#files-presets}
|
||
|
||
| ID пресета | Конвертирует | Маршрут | Базовый инструмент | Принимаемые входы | Необязательные настройки |
|
||
|-----------|----------|-------|-----------|-----------------|-------------------|
|
||
| `excel-to-csv` | Excel в CSV | `/api/v1/tools/files/excel-to-csv` | `convert-spreadsheet` | `.xlsx`, `.xls` | none |
|
||
|
||
## Примечания {#notes}
|
||
|
||
- Пресеты являются полноценными эндпоинтами API и также допустимы в пакетных запросах, где их базовый маршрут поддерживает пакетную обработку.
|
||
- Пресеты, использующие видеоконвертацию, могут возвращать `202 Accepted`; перед скачиванием результата подключитесь к SSE-эндпоинту прогресса задачи.
|
||
- Для расширенных параметров, не предоставляемых пресетом, вызывайте базовый инструмент-конвертер напрямую и задавайте выходной формат в `settings`.
|