Ir para o conteúdo principal

Encontre sua próxima ferramenta

Documentação/API/API de imagens: comprima, redimensione e converta
API

API de imagens: comprima, redimensione e converta

Redimensione, recorte, gire, comprima para uma qualidade ou um tamanho alvo em bytes e converta imagens em JPG, PNG, WebP ou AVIF em uma única chamada de pipeline.

Resposta curta

Envie POST /api/v1/pipeline/ com um sourceKey e uma etapa {"operation":"image","pipeline":[…]} com até 8 operações: resize (maxWidth, maxHeight), crop (x, y, width, height), rotate (degrees), compress (quality 1–100 ou targetBytes) e convert (jpg, png, webp, avif). Para imagens que já estão em Meus documentos, use /documents/{documentId}/process/ com {"operation":"image","pipeline":[…]}.

Comprima para a web

Um pipeline típico para fotos de produto limita o tamanho e converte para WebP. No nosso teste, um PNG de 224 KB virou um WebP de 30 KB com 400 px de largura em cerca de 4 segundos.

curl -X POST 'https://maxscanner.app/api/v1/pipeline/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{ "sourceKey": "users/<id>/media/inbox/…-photo.png", "steps": [ { "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1600 }, { "operation": "compress", "quality": 75, "format": "webp" } ] } ] }'

Atinja um tamanho de arquivo alvo

Portais de upload costumam exigir "menos de 200 KB". Use compress com targetBytes em vez de quality; o processador procura a maior qualidade que cabe no limite. As metas precisam estar entre o mínimo e o máximo que a API permite (até 20 MB).

{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }

Encadeie etapas de imagem com PDF e OCR

Os pipelines podem continuar depois da etapa de imagem: adicione {"operation":"convert","format":"pdf"} para colocar o resultado em um PDF, ou {"operation":"ocr","format":"pdf"} para torná-lo pesquisável. Quando a próxima etapa precisa, a etapa de imagem gera PNG automaticamente.

Perguntas frequentes

A compressão remove os metadados?

Imagens recodificadas não mantêm dados EXIF, como a localização GPS, o que geralmente é o desejado para imagens públicas.

Qual formato devo escolher?

WebP para sites, JPG quando a compatibilidade é o mais importante, PNG para capturas de tela e desenhos de traço, AVIF para os menores arquivos quando seu público usa navegadores modernos.

Guias relacionados