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.
Rode online
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.
Casos de uso
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.
Perguntas frequentes
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.
Para desenvolvedores — acesso via API
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.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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"}'const res = await fetch("https://api.kit.forhosting.com/pdf/thumbnail", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdf": "https://ejemplo.com/documento.pdf"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/thumbnail",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/thumbnail", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdf":"https://ejemplo.com/documento.pdf"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/thumbnail", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"pdf": "https://ejemplo.com/documento.pdf"
}Exemplo de resposta
{
"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.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_mb | 25 |
max_pages | 200 |
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
422 | task_failed | A tarefa falhou do nosso lado. Você não paga nada por ela. |