Пресеты конвертации

SnapOtter предоставляет 83 выделенных эндпоинта пресетов конвертации в дополнение к базовым инструментам-конвертерам. Каждый пресет фиксирует выходной формат и делегирует обработку своему базовому конвейеру, поэтому поведение, валидация и контракт вывода совпадают с базовым инструментом, указанным ниже.

Шаблон эндпоинта API

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-архива.

Пресеты изображений

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

Видеопресеты

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

Аудиопресеты

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

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

Пресеты файлов

ID пресета	Конвертирует	Маршрут	Базовый инструмент	Принимаемые входы	Необязательные настройки
excel-to-csv	Excel в CSV	/api/v1/tools/files/excel-to-csv	convert-spreadsheet	.xlsx, .xls	none

Примечания

• Пресеты являются полноценными эндпоинтами API и также допустимы в пакетных запросах, где их базовый маршрут поддерживает пакетную обработку.
• Пресеты, использующие видеоконвертацию, могут возвращать 202 Accepted; перед скачиванием результата подключитесь к SSE-эндпоинту прогресса задачи.
• Для расширенных параметров, не предоставляемых пресетом, вызывайте базовый инструмент-конвертер напрямую и задавайте выходной формат в settings.