ForHosting KIT · PDF e documentos

Liste imagens de um PDF: página, índice e dimensões

Transforme metadados aninhados de imagens de PDF em um inventário claro, fácil de consultar, filtrar e armazenar.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Informe os descritores das imagens de cada página, incluindo o número da página e as dimensões em pixels. O resultado é uma única lista plana na ordem de origem, com um índice iniciado em um para cada página. Isso é útil depois que um analisador de PDF identifica imagens incorporadas e antes de outro sistema precisar auditar, selecionar, extrair ou registrar esses itens.

Prepare os descritores de imagem por página

Comece pelos metadados gerados pelo seu leitor de PDF ou fluxo de extração. A entrada é uma lista de páginas, e cada item contém um número de página positivo e uma lista de imagens. Cada imagem precisa ter largura e altura em pixels, ambas representadas por inteiros positivos. Mantenha a ordem indicada pelo analisador, pois ela determina o índice da imagem no resultado. O índice começa em um a cada página, facilitando referências como “página 4, imagem 2” em relatórios. Uma página pode não ter imagens; nesse caso, envie uma lista de imagens vazia. Os números das páginas não precisam ser consecutivos, portanto você pode processar apenas uma seleção sem criar espaços reservados. Eles precisam ser únicos na solicitação. Essa estrutura explícita evita que a ausência de um rótulo associe silenciosamente uma imagem ao local errado.

Entenda o resultado em lista plana

A resposta contém uma lista de imagens com um registro para cada descritor encontrado nas páginas enviadas. Cada registro traz quatro campos: página, índice, largura e altura. A página é copiada do item que contém a imagem. O índice é calculado pela posição da imagem e volta a um na página seguinte. Largura e altura são validadas e copiadas sem redimensionamento, arredondamento, rotação ou conversão de unidade. Os registros preservam tanto a ordem dos itens de página quanto a ordem interna das imagens. Esse percurso estável torna as execuções determinísticas e permite comparar inventários sem uma etapa inesperada de ordenação. A capacidade não abre o PDF nem extrai dados binários; ela normaliza descritores já obtidos por um analisador. Dimensões iguais continuam em registros separados, pois podem representar recursos ou ocorrências diferentes.

Valide e use o inventário

Use o inventário plano sempre que os metadados aninhados por página forem inconvenientes. Uma verificação de qualidade pode sinalizar imagens abaixo da resolução mínima; uma tarefa de extração pode selecionar apenas itens maiores que uma miniatura; e um relatório pode contar imagens por página sem percorrer listas aninhadas várias vezes. Guarde página e índice juntos como localização legível, lembrando que o índice representa a ordem enviada e não um identificador interno do objeto PDF. A validação é rigorosa: a solicitação falha se as páginas estiverem ausentes ou vazias, se houver números de página inválidos ou repetidos, se imagens não for uma lista ou se largura e altura não forem inteiros positivos. Uma falha é melhor que um inventário parcial com aparência de completo. A operação é determinística, não usa rede e não retém os descritores. Você pode executá-la no navegador ou chamar a API por US$ 0,002 por solicitação.

Casos de uso

Auditar a resolução das imagens

Converta os metadados do analisador e encontre imagens cuja largura ou altura não atende aos requisitos de qualidade.

Planejar uma extração seletiva

Crie um manifesto de página e índice para selecionar imagens grandes e ignorar pequenos elementos decorativos depois.

Montar um relatório de recursos do PDF

Transforme resultados aninhados por página em linhas simples para uma planilha, banco de dados ou registro de processamento.

Perguntas frequentes

Esta capacidade lê ou envia o próprio PDF?

Não. Ela recebe os descritores de imagem por página que seu analisador de PDF já produziu.

Como os índices das imagens são atribuídos?

Eles começam em um, seguem a ordem enviada e reiniciam em um a cada página.

Uma página pode não ter imagens?

Sim. Envie essa página com uma lista de imagens vazia; ela não acrescentará registros ao resultado.

Os números das páginas precisam ser consecutivos?

Não. Você pode enviar páginas selecionadas, mas cada número precisa ser um inteiro positivo único na solicitação.

Quanto custa uma solicitação de API?

O preço da API é US$ 0,002 por solicitação. O executor no navegador está disponível para uso interativo.

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/extract-images-list

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/extract-images-list \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pages":[{"page":1,"images":[{"width":1200,"height":800},{"width":64,"height":64}]},{"page":2,"images":[{"width":1920,"height":1080}]}]}'

const res = await fetch("https://api.kit.forhosting.com/pdf/extract-images-list", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "pages": [
      {
        "page": 1,
        "images": [
          {
            "width": 1200,
            "height": 800
          },
          {
            "width": 64,
            "height": 64
          }
        ]
      },
      {
        "page": 2,
        "images": [
          {
            "width": 1920,
            "height": 1080
          }
        ]
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/pdf/extract-images-list",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "pages": [
        {
            "page": 1,
            "images": [
                {
                    "width": 1200,
                    "height": 800
                },
                {
                    "width": 64,
                    "height": 64
                }
            ]
        },
        {
            "page": 2,
            "images": [
                {
                    "width": 1920,
                    "height": 1080
                }
            ]
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/extract-images-list", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"pages":[{"page":1,"images":[{"width":1200,"height":800},{"width":64,"height":64}]},{"page":2,"images":[{"width":1920,"height":1080}]}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"pages":[{"page":1,"images":[{"width":1200,"height":800},{"width":64,"height":64}]},{"page":2,"images":[{"width":1920,"height":1080}]}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/extract-images-list", 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

{
  "pages": [
    {
      "page": 1,
      "images": [
        {
          "width": 1200,
          "height": 800
        },
        {
          "width": 64,
          "height": 64
        }
      ]
    },
    {
      "page": 2,
      "images": [
        {
          "width": 1920,
          "height": 1080
        }
      ]
    }
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "pdf.extract_images_list",
  "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_pages`	10000
`max_images_per_page`	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 →