Criar imagem a partir de PDF
Imagem → Criar imagem a partir de PDF
O Criar imagem a partir de PDF API converte PDF páginas para imagens. Enviar o PDF como Base64 (docContent), o nome do arquivo (docname), e, quando você se importa com quais páginas são exibidas, preencha pageNrs com uma linha de texto da mesma forma que você faria no Power Automate Número da página campo (all, 1,2-3,5,7-, -2, e assim por diante). imageAction e async são extras opcionais. Parâmetros A aba contém o mesmo guia rápido, exemplos e notas práticas que a documentação de integração.
Experimente a opção Criar Imagem a partir de PDF API
:::nota Referência rápida
Ponto final: POST /api/v2/CreateImages · Obrigatório: api-key, docContent, docname
:::
Use o formulário abaixo para enviar sua API chave e PDF (Base64). Opcionalmente, defina o intervalo de páginas ou a ação da imagem; a resposta é JSON Com dados de imagem. Não é necessário código, preencha os campos e clique. Enviar solicitação.
Visão geral, parâmetros e casos de uso
- Overview
- Parameters
- Use cases
O que é Criar Imagem a partir de PDF?
Este ponto de extremidade converte PDF páginas para imagens. Você fornece o PDF (Base64), docnamee opcionalmente pageNrs como uma corda: números simples, vírgulas, intervalos e palavras-chave como all (ver o Parâmetros (Consulte a aba para obter a lista completa de padrões e uma tabela de exemplos de 12 páginas). Você também pode enviar imageAction para largura, formato ou seleção avançada de página. A resposta é um JSON matriz de imagens (Base64) com nomes de arquivos e informações da página. Os formatos de saída suportados incluem jpeg, png, bmp, gif, tiff e outros.
Principais características
- Seleção de página: Tipo
pageNrscomo uma única linha de texto (mesmos padrões que o Power Automate Número da página campo:all, sozinho*,last,first,0,1, vírgulas, intervalos,7-,-1,-2, …). Opcional imageAction para seleção de largura, formato ou página alternativa. - Formato e tamanho: imageAction É possível definir WidthPixel e ImageExtension (jpeg, png, bmp, gif, tif, etc.).
- Assíncrono: Usar async para grandes PDFs.
:::dica Ideal para Use quando precisar de miniaturas ou imagens de PDF páginas. Combine com Comprimir imagem ou Redimensionar imagem para miniaturas. :::
API parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| api-key | corda | Sim | Seu PDF4me API chave, Base64 codificado. Obtenha-o do painel. |
| docContent | base64 | Sim | PDF conteúdo do arquivo (Base64). |
| docname | corda | Sim | PDF Nome do arquivo (ex.: exemplo.pdf). |
| pageNrs | corda | Não | Páginas a converter: uma linha de texto: números, vírgulas, hífenes e palavras-chave (all, sozinho *, last, first, 0, 1, -1, -2, …). Os mesmos padrões que o Power Automate Número da página campo. Veja a dica e a tabela de exemplo abaixo. |
| imageAction | objeto | Não | LarguraPixel, ExtensãoDaImagem, SeleçãoDaPágina (JSON). |
| async | booleano | Não | Ativar o processamento assíncrono. |
:::dica Como preencher Números das páginas
- Tipo
allpara converter cada página. Um solitário*(asterisco) faz o mesmo trabalho se você preferir. lasté apenas a página final.first,0ou simplesmente1Todas significam "apenas a primeira página".0é simplesmente outra maneira de dizer página 1; depois disso você ainda conta 2, 3, 4…-1é a última página.-2é a página anterior (em um arquivo de 12 páginas, essa é a página 11).- As vírgulas permitem unir as peças.
1,2-3,5,7-A sequência é a seguinte: página 1, páginas 2 a 3, página 5 e, em seguida, página 7 até o final. O espaço em branco após7-É isso que diz ao serviço "vá até a última página".
:::
1,2-3,5,7- em vez de 0,1-2,5,7-0,1-2,5,7- é legal, mas 0 e 1-2 ambas incluem a página 1Assim, você pode renderizar a primeira página duas vezes por acidente. 1,2-3,5,7- Diz o mesmo tipo de coisa, porém com menos sobreposição.
Exemplos de strings (veja um PDF de 12 páginas)
| O que você digita | O que você recebe |
|---|---|
1,2-3,5,7- | Página 1, páginas 2-3, página 5, depois páginas 7-12 |
all | Páginas 1 a 12 |
* | Igual a all |
-1 | Página 12 (última) |
-2 | Página 11 (segunda do final) |
last | Apenas na página 12 |
first | Apenas a página 1 |
0 | Apenas a página 1 (mesma ideia que first) |
Notas práticas
7-sem nada depois do hífen significa “da página 7 até a última página”.- Números de página inexistentes serão ignorados.
7-3(ao contrário) Ainda mantém a página 7 desse trecho quando a página 7 existe; não espere as páginas 6 e 5 desse trecho.- É permitido listar a mesma página mais de uma vez; cada menção pode gerar uma imagem diferente.
Quando usar Criar imagem a partir de PDF
- MiniaturasGere imagens de pré-visualização a partir de PDF páginas.
- Web e aplicativosUse imagens em vez de textos incorporados. PDF espectadores.
- OleodutosConverter páginas em imagens para Comprimir imagem, Redimensionar imagem, ou OCR.
Para esquemas de requisição/resposta e exemplos de código, consulte Criar imagem a partir de um PDF no PDF4me API documentos.
Pré-requisitos
Antes de usar este endpoint, certifique-se de que você possui:
- Um válido PDF4me API chave (Adquira o seu API Chave)
- A PDF arquivo em Base64 formato
Formato de resposta
O API retorna um JSON resposta contendo uma matriz de imagens convertidas, cada uma com:
- Conteúdo da imagem (base64 codificado)
- Nome do arquivo de imagem
- Informações sobre o número da página