ForHosting KIT · PDF e documentos

Como gerar miniatura de PDF

Esta ferramenta gera a miniatura de um PDF: uma imagem pequena da capa, ideal para ilustrar listas de documentos, resultados de busca e bibliotecas. Em vez de mostrar um ícone genérico de PDF, seu site ou sistema exibe a cara real de cada arquivo — e o usuário encontra o que procura de bater o olho.

● Estávelpor documentoUS$ 0,040
Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Ícone genérico não vende documento

Uma lista com trinta ícones vermelhos idênticos obriga o usuário a ler título por título. Uma lista com trinta capas diferentes se navega com os olhos: a apostila tem a capa azul, o contrato tem o timbre, o edital tem o brasão. Marketplaces de material de estudo, portais públicos e sistemas de gestão documental ganham navegação e taxa de clique quando cada PDF aparece com a própria cara em vez de um ícone de fábrica.

Como a geração funciona

Você envia o PDF pela API e recebe a imagem da primeira página, renderizada e pronta para exibir como capa. O fluxo típico é automático: no momento em que um documento novo entra no seu sistema, a chamada gera a miniatura e grava junto ao registro. A partir daí, listas, buscas e galerias usam a imagem sem tocar mais no arquivo original — que continua intacto.

Preço e limites

US$ 0,040 por chamada mais US$ 0,001 por unidade processada, com arquivos de até 25 MB e 200 páginas. Uma biblioteca com 2.000 documentos gera todas as capas por cerca de US$ 82 — uma única vez, porque a miniatura fica gravada no seu lado. Sem mensalidade e sem cadastro: pagamento por uso com preço publicado.

Marketplace de apostilas de concurso

Um site que vende material de estudo exibe a capa real de cada apostila na vitrine. A miniatura é gerada na hora em que o autor sobe o PDF — e produto com capa visível converte mais que ícone genérico.

GED corporativo navegável

O sistema de gestão de documentos da TecnoSul mostra a capa de cada contrato e proposta na listagem. Quem procura o contrato da matriz reconhece o timbre de longe, sem abrir arquivo por arquivo.

Portal de editais da prefeitura

Um portal municipal lista editais e atas com a primeira página visível. O cidadão identifica o documento certo pela cara — número grande do edital na capa — antes mesmo de clicar.

Drive interno de agência

Uma agência de Curitiba organiza entregáveis por cliente. As miniaturas transformam as pastas em um mural visual: a equipe acha o relatório de novembro pela capa, não pelo nome do arquivo.

A miniatura é sempre da primeira página?

Sim — a capa do documento é o que vira imagem. Se o seu documento tem uma folha de rosto em branco, vale reorganizar o PDF antes para que a página exibida seja a que representa o conteúdo.

Em que formato a imagem é entregue?

Como imagem pronta para web, adequada para listas e galerias. Você armazena a miniatura no seu lado e a reutiliza à vontade — a geração é feita uma vez por documento.

Quanto custa gerar capas para um acervo inteiro?

Cada documento custa US$ 0,040 de chamada mais US$ 0,001 de processamento. Um acervo de 500 PDFs sai por cerca de US$ 20,50, pago uma única vez — depois disso as capas são suas.

Preciso gerar a miniatura de novo toda vez que exibir o documento?

Não. Gere uma vez, salve a imagem junto ao registro e sirva a partir do seu armazenamento. Só faz sentido gerar de novo se o PDF mudar.

O documento enviado fica retido em algum lugar?

Ele é usado apenas para renderizar a capa e devolver a imagem. Não guardamos o conteúdo para outros fins nem o repassamos — o tratamento se limita à finalidade contratada, como determina a LGPD.

Funciona no celular dos meus usuários?

A miniatura é uma imagem comum: carrega em qualquer navegador, celular incluído, sem plugin nem leitor de PDF. É justamente o que torna as listas rápidas em conexões móveis.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/pdf/thumbnail

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/pdf/thumbnail \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf":"https://ejemplo.com/documento.pdf"}'
{
  "pdf": "https://ejemplo.com/documento.pdf"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.thumbnail",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,040
por documentoUS$ 0,001

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_mb25
max_pages200
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.
422task_failedA tarefa falhou do nosso lado. Você não paga nada por ela.

Ver a documentação completa do KIT →