Converter PDF em JPG ou PNG: o que o DPI muda e como exportar uma só página
PDF para imagem renderiza cada página em um ZIP, como PNG, a menos que você escolha JPEG. O formulário do navegador tem apenas formato e DPI; os campos de API para seleção de páginas e WebP são ignorados. Tamanhos de arquivo medidos a 150 e 300 DPI e como exportar uma única página.
O PDF para imagem transforma cada página de um PDF em um arquivo de imagem e devolve todos em um ZIP. O formulário do navegador tem duas configurações, formato (PNG ou JPEG) e DPI, e não há como escolher páginas nem WebP. As duas configurações mudam muito o tamanho da saída, e as seções abaixo mostram quanto.
Um exemplo completo: seis páginas, quatro configurações
O arquivo de teste era um documento de 6 páginas, tamanho US Letter, só com texto, gerado com o Ghostscript: 32 linhas de Times de 11 pt por página, 5.593 bytes. Ele foi enviado ao endpoint /api/v1/convert/pdf/img de uma versão local do servidor, uma vez para cada configuração. Os números vêm de uma execução em 2026-10-04; outro documento dará tamanhos diferentes.
| DPI | Formato | Pixels por página | Página 1 | ZIP, todas as 6 páginas |
|---|---|---|---|---|
| 150 | PNG | 1275 x 1650 | 53.400 bytes | 195.476 bytes |
| 300 | PNG | 2550 x 3300 | 127.391 bytes | 494.897 bytes |
| 150 | JPEG | 1275 x 1650 | 252.280 bytes | 1.340.684 bytes |
| 300 | JPEG | 2550 x 3300 | 685.891 bytes | 3.272.299 bytes |
As dimensões em pixels decorrem do tamanho da página: uma página Letter tem 8,5 por 11 polegadas, então 150 DPI dá 1275 por 1650 e 300 DPI dá 2550 por 3300. Dobrar o DPI quadruplica a quantidade de pixels, mas o ZIP de PNG cresceu cerca de 2,5 vezes aqui, porque as áreas brancas uniformes comprimem bem.
Para este arquivo, o JPEG foi maior que o PNG: a página 1 teve cerca de 4,7 vezes o tamanho a 150 DPI. O conselho comum de que o JPEG é o formato pequeno vale para fotografias. Uma página de texto é quase toda de branco uniforme com bordas nítidas, que o PNG comprime bem e o JPEG não. Uma página fotográfica ou digitalizada pode ir no sentido contrário, então teste uma página representativa antes de converter cem.
O ZIP leva o nome do PDF (contract.zip para contract.pdf) e contém de page.1.png a page.6.png, ou arquivos .jpg se você escolher JPEG.
Opções que a API aceita, mas ignora
O formulário do navegador não oferece estas duas, mas um script que as envia não recebe erro nem efeito:
- Seleção de páginas. Enviar
pageNumbers=2devolveu as seis páginas, não uma. Todas as páginas são sempre renderizadas. - WebP.
imageFormat=webpdevolveu arquivos PNG com os mesmos nomes e tamanhos depng. Sójpegejpgselecionam JPEG; qualquer outro valor cai em PNG.
Se você precisa de WebP, converta os arquivos PNG depois, em um editor de imagens.
Como obter uma só página
Recorte a página primeiro e depois converta o PDF de uma página:
- Abra o Extrair páginas, envie o PDF e digite
2como a página a manter. O resultado no teste foi um PDF de 1 página. - Envie esse PDF ao PDF para imagem, defina o DPI como 150 e mantenha PNG. O ZIP continha um arquivo,
page.1.png.
O arquivo se chama page.1.png mesmo vindo da página 2 do original, porque a numeração recomeça no PDF extraído. Renomeie-o se o número da página original importar.
DPI: onde o formulário e a API discordam
O formulário web vem preenchido com 300. Uma chamada direta à API que omite dpi renderiza a 150. Se um script produz imagens menores que as do navegador, é por isso; envie dpi explicitamente nos dois. Um valor não numérico é rejeitado com 400 e a mensagem "dpi must be a number".
Uma orientação aproximada, baseada na tabela acima e não em um benchmark de qualidade: 150 DPI basta para ler uma página inteira na tela; 300 DPI serve para impressão ou para ampliar letras miúdas. Nesta execução, o ZIP de PNG a 300 DPI teve cerca de 2,5 vezes o de 150 DPI, e um documento longo com muitas digitalizações multiplica isso.
O que não sobrevive
O resultado é feito de pixels, então:
- O texto deixa de ser selecionável e pesquisável. Para texto, use o PDF para RTF (texto), ou o OCR para Markdown para uma digitalização.
- Os links deixam de funcionar.
- Logotipos e diagramas vetoriais são rasterizados no DPI que você escolheu e ficarão borrados se ampliados depois. Execute de novo com um DPI maior.
Guarde o PDF original junto das imagens. Voltar com o Imagem para PDF dá um PDF feito de fotos de texto, não o documento original.
Um PDF protegido por senha é rejeitado com 400, This PDF is password-protected. Enter its password., e um campo password enviado a este endpoint não muda isso. Remova a senha antes com o Remover senha.
Confira antes de usar o conjunto em massa
Abra uma página do ZIP com zoom de 100% e confira letras miúdas e linhas finas. Se estiver macia, aumente o DPI e execute de novo; se o ZIP estiver grande demais, diminua o DPI, ou passe para JPEG só depois de confirmar que ele realmente fica menor nas suas páginas.