Predefinições de Conversão

O SnapOtter expõe 83 endpoints de predefinições de conversão dedicados, além das ferramentas conversoras base. Cada predefinição fixa o formato de saída e delega ao seu pipeline de processamento base, de modo que o comportamento, a validação e o contrato de saída correspondam à ferramenta base listada abaixo.

Padrão de Endpoint da API

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

Envie multipart/form-data com uma parte file e uma string JSON opcional settings. As predefinições seguem o contrato de resposta da ferramenta base. Predefinições rápidas geralmente retornam 200 com um downloadUrl, mas podem retornar 202 se excederem a janela de espera síncrona. Predefinições de vídeo e predefinições longas de arquivo/documento retornam 202 e transmitem o progresso a partir de /api/v1/jobs/<jobId>/progress. Predefinições de PDF para imagem retornam URLs de download por página, além de uma URL de ZIP.

Predefinições de Imagem

ID da Predefinição	Converte	Rota	Ferramenta base	Entradas aceitas	Configurações opcionais
jpg-to-png	JPG para PNG	/api/v1/tools/image/jpg-to-png	convert	.jpg, .jpeg	quality
png-to-jpg	PNG para JPG	/api/v1/tools/image/png-to-jpg	convert	.png	quality
jpg-to-webp	JPG para WebP	/api/v1/tools/image/jpg-to-webp	convert	.jpg, .jpeg	quality
png-to-webp	PNG para WebP	/api/v1/tools/image/png-to-webp	convert	.png	quality
webp-to-jpg	WebP para JPG	/api/v1/tools/image/webp-to-jpg	convert	.webp	quality
webp-to-png	WebP para PNG	/api/v1/tools/image/webp-to-png	convert	.webp	quality
jpg-to-avif	JPG para AVIF	/api/v1/tools/image/jpg-to-avif	convert	.jpg, .jpeg	quality
png-to-avif	PNG para AVIF	/api/v1/tools/image/png-to-avif	convert	.png	quality
webp-to-avif	WebP para AVIF	/api/v1/tools/image/webp-to-avif	convert	.webp	quality
heic-to-jpg	HEIC para JPG	/api/v1/tools/image/heic-to-jpg	convert	.heic, .heif	quality
heic-to-png	HEIC para PNG	/api/v1/tools/image/heic-to-png	convert	.heic, .heif	quality
heic-to-avif	HEIC para AVIF	/api/v1/tools/image/heic-to-avif	convert	.heic, .heif	quality
jpg-to-gif	JPG para GIF	/api/v1/tools/image/jpg-to-gif	convert	.jpg, .jpeg	quality
png-to-gif	PNG para GIF	/api/v1/tools/image/png-to-gif	convert	.png	quality
gif-to-jpg	GIF para JPG	/api/v1/tools/image/gif-to-jpg	convert	.gif	quality
gif-to-png	GIF para PNG	/api/v1/tools/image/gif-to-png	convert	.gif	quality
webp-to-gif	WebP para GIF	/api/v1/tools/image/webp-to-gif	convert	.webp	quality
jpg-to-tiff	JPG para TIFF	/api/v1/tools/image/jpg-to-tiff	convert	.jpg, .jpeg	quality
png-to-tiff	PNG para TIFF	/api/v1/tools/image/png-to-tiff	convert	.png	quality
tiff-to-jpg	TIFF para JPG	/api/v1/tools/image/tiff-to-jpg	convert	.tiff, .tif	quality
tiff-to-png	TIFF para PNG	/api/v1/tools/image/tiff-to-png	convert	.tiff, .tif	quality
psd-to-jpg	PSD para JPG	/api/v1/tools/image/psd-to-jpg	convert	.psd	quality
psd-to-png	PSD para PNG	/api/v1/tools/image/psd-to-png	convert	.psd	quality
png-to-eps	PNG para EPS	/api/v1/tools/image/png-to-eps	convert	.png	quality
jpg-to-eps	JPG para EPS	/api/v1/tools/image/jpg-to-eps	convert	.jpg, .jpeg	quality
eps-to-png	EPS para PNG	/api/v1/tools/image/eps-to-png	convert	.eps	quality
eps-to-jpg	EPS para JPG	/api/v1/tools/image/eps-to-jpg	convert	.eps	quality
png-to-svg	PNG para SVG	/api/v1/tools/image/png-to-svg	vectorize	.png	nenhuma
jpg-to-svg	JPG para SVG	/api/v1/tools/image/jpg-to-svg	vectorize	.jpg, .jpeg	nenhuma
tiff-to-svg	TIFF para SVG	/api/v1/tools/image/tiff-to-svg	vectorize	.tiff, .tif	nenhuma
psd-to-svg	PSD para SVG	/api/v1/tools/image/psd-to-svg	vectorize	.psd	nenhuma
eps-to-svg	EPS para SVG	/api/v1/tools/image/eps-to-svg	vectorize	.eps	nenhuma
svg-to-png	SVG para PNG	/api/v1/tools/image/svg-to-png	svg-to-raster	.svg, .svgz	quality, width, height, dpi, backgroundColor
svg-to-jpg	SVG para JPG	/api/v1/tools/image/svg-to-jpg	svg-to-raster	.svg, .svgz	quality, width, height, dpi, backgroundColor
jpg-to-pdf	JPG para PDF	/api/v1/tools/image/jpg-to-pdf	image-to-pdf	.jpg, .jpeg	pageSize, orientation, margin, targetSize, collate
png-to-pdf	PNG para PDF	/api/v1/tools/image/png-to-pdf	image-to-pdf	.png	pageSize, orientation, margin, targetSize, collate
heic-to-pdf	HEIC para PDF	/api/v1/tools/image/heic-to-pdf	image-to-pdf	.heic, .heif	pageSize, orientation, margin, targetSize, collate
tiff-to-pdf	TIFF para PDF	/api/v1/tools/image/tiff-to-pdf	image-to-pdf	.tiff, .tif	pageSize, orientation, margin, targetSize, collate
webp-to-pdf	WebP para PDF	/api/v1/tools/image/webp-to-pdf	image-to-pdf	.webp	pageSize, orientation, margin, targetSize, collate
gif-to-pdf	GIF para PDF	/api/v1/tools/image/gif-to-pdf	image-to-pdf	.gif	pageSize, orientation, margin, targetSize, collate
eps-to-pdf	EPS para PDF	/api/v1/tools/image/eps-to-pdf	image-to-pdf	.eps	pageSize, orientation, margin, targetSize, collate

Predefinições de Vídeo

ID da Predefinição	Converte	Rota	Ferramenta base	Entradas aceitas	Configurações opcionais
mov-to-mp4	MOV para MP4	/api/v1/tools/video/mov-to-mp4	convert-video	.mov	quality
webm-to-mp4	WEBM para MP4	/api/v1/tools/video/webm-to-mp4	convert-video	.webm	quality
mkv-to-mp4	MKV para MP4	/api/v1/tools/video/mkv-to-mp4	convert-video	.mkv	quality
avi-to-mp4	AVI para MP4	/api/v1/tools/video/avi-to-mp4	convert-video	.avi	quality
mp4-to-mov	MP4 para MOV	/api/v1/tools/video/mp4-to-mov	convert-video	.mp4	quality
mp4-to-webm	MP4 para WEBM	/api/v1/tools/video/mp4-to-webm	convert-video	.mp4	quality
webm-to-mov	WEBM para MOV	/api/v1/tools/video/webm-to-mov	convert-video	.webm	quality
mkv-to-mov	MKV para MOV	/api/v1/tools/video/mkv-to-mov	convert-video	.mkv	quality
avi-to-mov	AVI para MOV	/api/v1/tools/video/avi-to-mov	convert-video	.avi	quality
mp4-to-avi	MP4 para AVI	/api/v1/tools/video/mp4-to-avi	convert-video	.mp4	quality
mov-to-avi	MOV para AVI	/api/v1/tools/video/mov-to-avi	convert-video	.mov	quality
mkv-to-avi	MKV para AVI	/api/v1/tools/video/mkv-to-avi	convert-video	.mkv	quality
avi-to-mkv	AVI para MKV	/api/v1/tools/video/avi-to-mkv	convert-video	.avi	quality
mp4-to-gif	MP4 para GIF	/api/v1/tools/video/mp4-to-gif	video-to-gif	.mp4	fps, width, startS, durationS
mov-to-gif	MOV para GIF	/api/v1/tools/video/mov-to-gif	video-to-gif	.mov	fps, width, startS, durationS
mkv-to-gif	MKV para GIF	/api/v1/tools/video/mkv-to-gif	video-to-gif	.mkv	fps, width, startS, durationS
avi-to-gif	AVI para GIF	/api/v1/tools/video/avi-to-gif	video-to-gif	.avi	fps, width, startS, durationS
gif-to-mp4	GIF para MP4	/api/v1/tools/video/gif-to-mp4	gif-to-video	.gif	nenhuma
gif-to-webm	GIF para WEBM	/api/v1/tools/video/gif-to-webm	gif-to-video	.gif	nenhuma
gif-to-mov	GIF para MOV	/api/v1/tools/video/gif-to-mov	gif-to-video	.gif	nenhuma
mp4-to-mp3	MP4 para MP3	/api/v1/tools/video/mp4-to-mp3	extract-audio	.mp4	nenhuma
mov-to-mp3	MOV para MP3	/api/v1/tools/video/mov-to-mp3	extract-audio	.mov	nenhuma
mkv-to-mp3	MKV para MP3	/api/v1/tools/video/mkv-to-mp3	extract-audio	.mkv	nenhuma
webm-to-mp3	WEBM para MP3	/api/v1/tools/video/webm-to-mp3	extract-audio	.webm	nenhuma
avi-to-mp3	AVI para MP3	/api/v1/tools/video/avi-to-mp3	extract-audio	.avi	nenhuma
mp4-to-wav	MP4 para WAV	/api/v1/tools/video/mp4-to-wav	extract-audio	.mp4	nenhuma
mov-to-wav	MOV para WAV	/api/v1/tools/video/mov-to-wav	extract-audio	.mov	nenhuma
mp4-to-ogg	MP4 para OGG	/api/v1/tools/video/mp4-to-ogg	extract-audio	.mp4	nenhuma

Predefinições de Áudio

ID da Predefinição	Converte	Rota	Ferramenta base	Entradas aceitas	Configurações opcionais
m4a-to-mp3	M4A para MP3	/api/v1/tools/audio/m4a-to-mp3	convert-audio	.m4a	nenhuma
m4a-to-wav	M4A para WAV	/api/v1/tools/audio/m4a-to-wav	convert-audio	.m4a	nenhuma
aac-to-mp3	AAC para MP3	/api/v1/tools/audio/aac-to-mp3	convert-audio	.aac	nenhuma
aac-to-wav	AAC para WAV	/api/v1/tools/audio/aac-to-wav	convert-audio	.aac	nenhuma
aac-to-flac	AAC para FLAC	/api/v1/tools/audio/aac-to-flac	convert-audio	.aac	nenhuma
ogg-to-mp3	OGG para MP3	/api/v1/tools/audio/ogg-to-mp3	convert-audio	.ogg	nenhuma
ogg-to-wav	OGG para WAV	/api/v1/tools/audio/ogg-to-wav	convert-audio	.ogg	nenhuma
wav-to-mp3	WAV para MP3	/api/v1/tools/audio/wav-to-mp3	convert-audio	.wav	nenhuma
mp3-to-wav	MP3 para WAV	/api/v1/tools/audio/mp3-to-wav	convert-audio	.mp3	nenhuma
flac-to-mp3	FLAC para MP3	/api/v1/tools/audio/flac-to-mp3	convert-audio	.flac	nenhuma

Predefinições de PDF

ID da Predefinição	Converte	Rota	Ferramenta base	Entradas aceitas	Configurações opcionais
pdf-to-jpg	PDF para JPG	/api/v1/tools/pdf/pdf-to-jpg	pdf-to-image	.pdf	dpi, quality, colorMode, pages
pdf-to-png	PDF para PNG	/api/v1/tools/pdf/pdf-to-png	pdf-to-image	.pdf	dpi, quality, colorMode, pages
pdf-to-tiff	PDF para TIFF	/api/v1/tools/pdf/pdf-to-tiff	pdf-to-image	.pdf	dpi, quality, colorMode, pages

Predefinições de Arquivos

ID da Predefinição	Converte	Rota	Ferramenta base	Entradas aceitas	Configurações opcionais
excel-to-csv	Excel para CSV	/api/v1/tools/files/excel-to-csv	convert-spreadsheet	.xlsx, .xls	nenhuma

Notas

• As predefinições são endpoints de API de primeira classe e também são válidas em requisições em lote, sempre que sua rota base suportar processamento em lote.
• Predefinições que usam conversão de vídeo podem retornar 202 Accepted; conecte-se ao endpoint SSE de progresso do job antes de baixar o resultado.
• Para opções avançadas não expostas por uma predefinição, chame diretamente a ferramenta conversora base e defina o formato de saída em settings.