ForHosting KIT · PDF e documentos

PDF em sequência de imagens

Este gerador de nomes para sequências de imagens de PDF cria a lista exata e ordenada usada em uma conversão página por página.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe o total de páginas e escolha PNG ou JPG; o resultado traz um nome previsível para cada página. A numeração recebe os zeros iniciais necessários para manter a ordem em classificações de texto. A ferramenta não envia, examina nem converte o PDF, portanto você pode planejar exportações, validar resultados e preparar tarefas posteriores antes mesmo de as imagens existirem.

Planeje toda a sequência antes da conversão

Fluxos de conversão de PDF muitas vezes precisam conhecer as saídas esperadas antes que a renderização comece. Você pode precisar reservar chaves de armazenamento, criar uma linha de banco de dados para cada página ou testar se nenhuma imagem ficou ausente. Informe o total de páginas e selecione PNG ou JPG para receber um manifesto completo. Cada nome começa com page-, seguido pelo número da página a partir de um e pela extensão escolhida. O PDF em si não é necessário, pois a finalidade é planejar nomes, e não ler ou renderizar o documento. Essa separação torna o resultado rápido, reproduzível e adequado a uma etapa anterior do processo. Um documento de doze páginas produz nomes de page-01 a page-12; documentos com centenas de páginas recebem automaticamente um campo numérico mais largo. O total e o formato também aparecem no resultado para facilitar a conferência por outros serviços.

Mantenha a ordem correta em pastas e armazenamentos

Nomes sem preenchimento causam um problema discreto: a classificação comum de texto posiciona page-10 antes de page-2. Esta capacidade evita isso calculando a quantidade de dígitos da última página e acrescentando zeros à esquerda de todos os números. Nove páginas usam um dígito, doze usam dois e cento e vinte usam três. Assim, tanto a lista retornada quanto os nomes exibidos em armazenamento de objetos, arquivos compactados, terminais e gerenciadores de arquivos preservam a ordem das páginas. A contagem começa em um porque representa a numeração vista por quem lê o PDF, não índices internos iniciados em zero. A extensão escolhida é aplicada de modo uniforme e somente png e jpg são aceitos. Qualquer outro valor é recusado para que o manifesto não prometa arquivos incompatíveis e para que erros de digitação sejam detectados antes de um trabalho de conversão mais caro.

Use o manifesto como um contrato determinístico

O resultado conecta etapas independentes de um fluxo de documentos. Um conversor pode atribuir um nome a cada página, a etapa de envio pode reservar as chaves correspondentes e a validação pode comparar os arquivos gerados com a lista esperada. O algoritmo não usa rede, horário atual, aleatoriedade nem metadados do documento; entradas iguais sempre produzem a mesma saída. Essa característica ajuda em testes automatizados, tarefas com repetição segura, builds reproduzíveis e trilhas de auditoria. O limite de dez mil páginas impede que uma solicitação incorreta crie uma lista sem controle ou sobrecarregue o navegador. Totais inválidos e formatos não aceitos geram erros de entrada, sem correções silenciosas. A execução pela API custa US$ 0,002, e a mesma lógica também pode ser usada no navegador. Esta ferramenta lista apenas nomes planejados: outra capacidade deve gerar as imagens, que depois podem ser comparadas com o manifesto.

Casos de uso

Reserve chaves de armazenamento

Crie todos os nomes esperados antes que o renderizador envie as imagens das páginas.

Valide a conversão completa

Compare a pasta de saída com o manifesto para localizar páginas ausentes ou inesperadas.

Monte filas por página

Crie uma tarefa determinística para cada página com um destino PNG ou JPG estável.

Perguntas frequentes

Esta capacidade converte o PDF?

Não. Ela gera os nomes previstos para uma conversão página por página, mas não lê nem renderiza o PDF.

Quais formatos de imagem são aceitos?

As extensões aceitas são png e jpg. Qualquer outro formato gera um erro de entrada inválida.

Por que alguns números têm zeros à esquerda?

Os zeros igualam a largura dos números e mantêm os arquivos na ordem das páginas quando classificados como texto.

A numeração começa em zero ou em um?

Ela começa em um e termina no total informado, como a numeração normalmente exibida a quem lê o PDF.

Quanto custa uma solicitação via API?

Uma solicitação via API custa US$ 0,002. A mesma lógica determinística também pode ser executada no navegador.

Qual é o maior total de páginas aceito?

O máximo é de dez mil páginas, limitando o uso de memória e o tamanho da lista retornada.

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

POSThttps://api.kit.forhosting.com/pdf/to-image-sequence

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/to-image-sequence \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_count":12,"format":"png"}'

const res = await fetch("https://api.kit.forhosting.com/pdf/to-image-sequence", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "page_count": 12,
    "format": "png"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/to-image-sequence",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "page_count": 12,
    "format": "png"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/to-image-sequence", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"page_count":12,"format":"png"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"page_count":12,"format":"png"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/to-image-sequence", 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

{
  "page_count": 12,
  "format": "png"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.to_image_sequence",
  "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

por chamadaUS$ 0,002

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

Limites

max_items 10000

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.

Ver a documentação completa do KIT →