SnapOtter/apps/docs/it/tools/conversion-presets.md

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
Endpoint di preset di conversione dedicati generati dal catalogo di strumenti di SnapOtter.	faad6efcb9a9	human	15efc541fa93

Conversion Presets

SnapOtter espone 83 endpoint di preset di conversione dedicati oltre agli strumenti di conversione di base. Ogni preset blocca il formato di output e delega alla propria pipeline di elaborazione di base, quindi il comportamento, la validazione e il contratto di output corrispondono allo strumento di base elencato di seguito.

API Endpoint Pattern

POST /api/v1/tools/<section>/<presetId>

Invia multipart/form-data con una parte file e una stringa JSON settings opzionale. I preset seguono il contratto di risposta dello strumento di base. I preset veloci di solito restituiscono 200 con un downloadUrl, ma possono restituire 202 se superano la finestra di attesa sincrona. I preset video e i preset lunghi per file/documenti restituiscono 202 e stream di avanzamento da /api/v1/jobs/<jobId>/progress. I preset PDF-to-image restituiscono gli URL di download delle pagine più un URL ZIP.

Image Presets

Preset ID	Converts	Route	Base tool	Accepted inputs	Optional settings
jpg-to-png	JPG to PNG	/api/v1/tools/image/jpg-to-png	convert	.jpg, .jpeg	quality
png-to-jpg	PNG to JPG	/api/v1/tools/image/png-to-jpg	convert	.png	quality
jpg-to-webp	JPG to WebP	/api/v1/tools/image/jpg-to-webp	convert	.jpg, .jpeg	quality
png-to-webp	PNG to WebP	/api/v1/tools/image/png-to-webp	convert	.png	quality
webp-to-jpg	WebP to JPG	/api/v1/tools/image/webp-to-jpg	convert	.webp	quality
webp-to-png	WebP to PNG	/api/v1/tools/image/webp-to-png	convert	.webp	quality
jpg-to-avif	JPG to AVIF	/api/v1/tools/image/jpg-to-avif	convert	.jpg, .jpeg	quality
png-to-avif	PNG to AVIF	/api/v1/tools/image/png-to-avif	convert	.png	quality
webp-to-avif	WebP to AVIF	/api/v1/tools/image/webp-to-avif	convert	.webp	quality
heic-to-jpg	HEIC to JPG	/api/v1/tools/image/heic-to-jpg	convert	.heic, .heif	quality
heic-to-png	HEIC to PNG	/api/v1/tools/image/heic-to-png	convert	.heic, .heif	quality
heic-to-avif	HEIC to AVIF	/api/v1/tools/image/heic-to-avif	convert	.heic, .heif	quality
jpg-to-gif	JPG to GIF	/api/v1/tools/image/jpg-to-gif	convert	.jpg, .jpeg	quality
png-to-gif	PNG to GIF	/api/v1/tools/image/png-to-gif	convert	.png	quality
gif-to-jpg	GIF to JPG	/api/v1/tools/image/gif-to-jpg	convert	.gif	quality
gif-to-png	GIF to PNG	/api/v1/tools/image/gif-to-png	convert	.gif	quality
webp-to-gif	WebP to GIF	/api/v1/tools/image/webp-to-gif	convert	.webp	quality
jpg-to-tiff	JPG to TIFF	/api/v1/tools/image/jpg-to-tiff	convert	.jpg, .jpeg	quality
png-to-tiff	PNG to TIFF	/api/v1/tools/image/png-to-tiff	convert	.png	quality
tiff-to-jpg	TIFF to JPG	/api/v1/tools/image/tiff-to-jpg	convert	.tiff, .tif	quality
tiff-to-png	TIFF to PNG	/api/v1/tools/image/tiff-to-png	convert	.tiff, .tif	quality
psd-to-jpg	PSD to JPG	/api/v1/tools/image/psd-to-jpg	convert	.psd	quality
psd-to-png	PSD to PNG	/api/v1/tools/image/psd-to-png	convert	.psd	quality
png-to-eps	PNG to EPS	/api/v1/tools/image/png-to-eps	convert	.png	quality
jpg-to-eps	JPG to EPS	/api/v1/tools/image/jpg-to-eps	convert	.jpg, .jpeg	quality
eps-to-png	EPS to PNG	/api/v1/tools/image/eps-to-png	convert	.eps	quality
eps-to-jpg	EPS to JPG	/api/v1/tools/image/eps-to-jpg	convert	.eps	quality
png-to-svg	PNG to SVG	/api/v1/tools/image/png-to-svg	vectorize	.png	none
jpg-to-svg	JPG to SVG	/api/v1/tools/image/jpg-to-svg	vectorize	.jpg, .jpeg	none
tiff-to-svg	TIFF to SVG	/api/v1/tools/image/tiff-to-svg	vectorize	.tiff, .tif	none
psd-to-svg	PSD to SVG	/api/v1/tools/image/psd-to-svg	vectorize	.psd	none
eps-to-svg	EPS to SVG	/api/v1/tools/image/eps-to-svg	vectorize	.eps	none
svg-to-png	SVG to PNG	/api/v1/tools/image/svg-to-png	svg-to-raster	.svg, .svgz	quality, width, height, dpi, backgroundColor
svg-to-jpg	SVG to JPG	/api/v1/tools/image/svg-to-jpg	svg-to-raster	.svg, .svgz	quality, width, height, dpi, backgroundColor
jpg-to-pdf	JPG to PDF	/api/v1/tools/image/jpg-to-pdf	image-to-pdf	.jpg, .jpeg	pageSize, orientation, margin, targetSize, collate
png-to-pdf	PNG to PDF	/api/v1/tools/image/png-to-pdf	image-to-pdf	.png	pageSize, orientation, margin, targetSize, collate
heic-to-pdf	HEIC to PDF	/api/v1/tools/image/heic-to-pdf	image-to-pdf	.heic, .heif	pageSize, orientation, margin, targetSize, collate
tiff-to-pdf	TIFF to PDF	/api/v1/tools/image/tiff-to-pdf	image-to-pdf	.tiff, .tif	pageSize, orientation, margin, targetSize, collate
webp-to-pdf	WebP to PDF	/api/v1/tools/image/webp-to-pdf	image-to-pdf	.webp	pageSize, orientation, margin, targetSize, collate
gif-to-pdf	GIF to PDF	/api/v1/tools/image/gif-to-pdf	image-to-pdf	.gif	pageSize, orientation, margin, targetSize, collate
eps-to-pdf	EPS to PDF	/api/v1/tools/image/eps-to-pdf	image-to-pdf	.eps	pageSize, orientation, margin, targetSize, collate

Video Presets

Preset ID	Converts	Route	Base tool	Accepted inputs	Optional settings
mov-to-mp4	MOV to MP4	/api/v1/tools/video/mov-to-mp4	convert-video	.mov	quality
webm-to-mp4	WEBM to MP4	/api/v1/tools/video/webm-to-mp4	convert-video	.webm	quality
mkv-to-mp4	MKV to MP4	/api/v1/tools/video/mkv-to-mp4	convert-video	.mkv	quality
avi-to-mp4	AVI to MP4	/api/v1/tools/video/avi-to-mp4	convert-video	.avi	quality
mp4-to-mov	MP4 to MOV	/api/v1/tools/video/mp4-to-mov	convert-video	.mp4	quality
mp4-to-webm	MP4 to WEBM	/api/v1/tools/video/mp4-to-webm	convert-video	.mp4	quality
webm-to-mov	WEBM to MOV	/api/v1/tools/video/webm-to-mov	convert-video	.webm	quality
mkv-to-mov	MKV to MOV	/api/v1/tools/video/mkv-to-mov	convert-video	.mkv	quality
avi-to-mov	AVI to MOV	/api/v1/tools/video/avi-to-mov	convert-video	.avi	quality
mp4-to-avi	MP4 to AVI	/api/v1/tools/video/mp4-to-avi	convert-video	.mp4	quality
mov-to-avi	MOV to AVI	/api/v1/tools/video/mov-to-avi	convert-video	.mov	quality
mkv-to-avi	MKV to AVI	/api/v1/tools/video/mkv-to-avi	convert-video	.mkv	quality
avi-to-mkv	AVI to MKV	/api/v1/tools/video/avi-to-mkv	convert-video	.avi	quality
mp4-to-gif	MP4 to GIF	/api/v1/tools/video/mp4-to-gif	video-to-gif	.mp4	fps, width, startS, durationS
mov-to-gif	MOV to GIF	/api/v1/tools/video/mov-to-gif	video-to-gif	.mov	fps, width, startS, durationS
mkv-to-gif	MKV to GIF	/api/v1/tools/video/mkv-to-gif	video-to-gif	.mkv	fps, width, startS, durationS
avi-to-gif	AVI to GIF	/api/v1/tools/video/avi-to-gif	video-to-gif	.avi	fps, width, startS, durationS
gif-to-mp4	GIF to MP4	/api/v1/tools/video/gif-to-mp4	gif-to-video	.gif	none
gif-to-webm	GIF to WEBM	/api/v1/tools/video/gif-to-webm	gif-to-video	.gif	none
gif-to-mov	GIF to MOV	/api/v1/tools/video/gif-to-mov	gif-to-video	.gif	none
mp4-to-mp3	MP4 to MP3	/api/v1/tools/video/mp4-to-mp3	extract-audio	.mp4	none
mov-to-mp3	MOV to MP3	/api/v1/tools/video/mov-to-mp3	extract-audio	.mov	none
mkv-to-mp3	MKV to MP3	/api/v1/tools/video/mkv-to-mp3	extract-audio	.mkv	none
webm-to-mp3	WEBM to MP3	/api/v1/tools/video/webm-to-mp3	extract-audio	.webm	none
avi-to-mp3	AVI to MP3	/api/v1/tools/video/avi-to-mp3	extract-audio	.avi	none
mp4-to-wav	MP4 to WAV	/api/v1/tools/video/mp4-to-wav	extract-audio	.mp4	none
mov-to-wav	MOV to WAV	/api/v1/tools/video/mov-to-wav	extract-audio	.mov	none
mp4-to-ogg	MP4 to OGG	/api/v1/tools/video/mp4-to-ogg	extract-audio	.mp4	none

Audio Presets

Preset ID	Converts	Route	Base tool	Accepted inputs	Optional settings
m4a-to-mp3	M4A to MP3	/api/v1/tools/audio/m4a-to-mp3	convert-audio	.m4a	none
m4a-to-wav	M4A to WAV	/api/v1/tools/audio/m4a-to-wav	convert-audio	.m4a	none
aac-to-mp3	AAC to MP3	/api/v1/tools/audio/aac-to-mp3	convert-audio	.aac	none
aac-to-wav	AAC to WAV	/api/v1/tools/audio/aac-to-wav	convert-audio	.aac	none
aac-to-flac	AAC to FLAC	/api/v1/tools/audio/aac-to-flac	convert-audio	.aac	none
ogg-to-mp3	OGG to MP3	/api/v1/tools/audio/ogg-to-mp3	convert-audio	.ogg	none
ogg-to-wav	OGG to WAV	/api/v1/tools/audio/ogg-to-wav	convert-audio	.ogg	none
wav-to-mp3	WAV to MP3	/api/v1/tools/audio/wav-to-mp3	convert-audio	.wav	none
mp3-to-wav	MP3 to WAV	/api/v1/tools/audio/mp3-to-wav	convert-audio	.mp3	none
flac-to-mp3	FLAC to MP3	/api/v1/tools/audio/flac-to-mp3	convert-audio	.flac	none

PDF Presets

Preset ID	Converts	Route	Base tool	Accepted inputs	Optional settings
pdf-to-jpg	PDF to JPG	/api/v1/tools/pdf/pdf-to-jpg	pdf-to-image	.pdf	dpi, quality, colorMode, pages
pdf-to-png	PDF to PNG	/api/v1/tools/pdf/pdf-to-png	pdf-to-image	.pdf	dpi, quality, colorMode, pages
pdf-to-tiff	PDF to TIFF	/api/v1/tools/pdf/pdf-to-tiff	pdf-to-image	.pdf	dpi, quality, colorMode, pages

Files Presets

Preset ID	Converts	Route	Base tool	Accepted inputs	Optional settings
excel-to-csv	Excel to CSV	/api/v1/tools/files/excel-to-csv	convert-spreadsheet	.xlsx, .xls	none

Notes

• I preset sono endpoint API di prima classe e sono validi anche nelle richieste batch dove la loro route di base supporta l'elaborazione batch.
• I preset che usano la conversione video possono restituire 202 Accepted; connettiti all'endpoint SSE di avanzamento del job prima di scaricare il risultato.
• Per le opzioni avanzate non esposte da un preset, chiama direttamente lo strumento di conversione di base e imposta il formato di output in settings.