Converta imagens em PDF usando a API REST em Python

PDF é um dos formatos populares para compartilhar e imprimir documentos. Muitas vezes precisamos converter documentos de diferentes formatos e imagens para PDF. Requer muito tempo e esforço para desenvolver tais ferramentas. Portanto, é melhor usar ferramentas especializadas já desenvolvidas que fornecem uma solução flexível e de fácil manutenção para suas necessidades. Para essa finalidade, a API REST de conversão de imagem para PDF e o SDK do Python permitem a conversão de documentos de formatos suportados para PDF programaticamente na nuvem. Neste artigo, aprenderemos como converter imagens em PDF usando uma API REST em Python.

Os seguintes tópicos serão abordados neste artigo:

API REST de conversão de imagem para PDF e SDK do Python

Para converter imagens JPG ou PNG em PDF, usaremos a API Python SDK of GroupDocs.Conversion Cloud. Instale-o usando o seguinte comando no console:

pip install groupdocs_converison_cloud

Por favor, obtenha seu ID e Segredo do cliente no painel antes de seguir as etapas mencionadas. Depois de ter seu ID e segredo, adicione o código conforme mostrado abaixo:

# Este exemplo de código demonstra como definir o ID e o segredo do cliente.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

Converter JPG para PDF usando uma API REST em Python

Podemos converter imagens em documentos PDF seguindo as etapas simples abaixo:

  1. Carregar o arquivo de imagem JPG para a nuvem
  2. Converter JPG para PDF usando Python
  3. Baixe o arquivo PDF convertido

Carregue a imagem

Em primeiro lugar, faremos o upload do arquivo de imagem JPG para a nuvem usando o seguinte exemplo de código:

# Este exemplo de código demonstra como fazer upload do arquivo de imagem JPG para a nuvem.
# Criar instância da API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# solicitação de upload de arquivo
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# carregar arquivo de amostra
response = file_api.upload_file(request)

Como resultado, o arquivo carregado estará disponível na seção de arquivos do painel na nuvem.

Converta JPG para PDF usando Python

Podemos converter imagens JPG em documentos PDF programaticamente seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do ConvertApi.
  • Em seguida, crie uma instância do ConvertSettings.
  • Em seguida, defina o caminho do arquivo JPG.
  • E atribua “pdf” ao formato.
  • Além disso, forneça o caminho do arquivo de saída.
  • Depois disso, crie ConvertDocumentRequest com ConvertSettings como argumento.
  • Por fim, chame o método ConvertApi.convert\document() com ConvertDocumentRequest para salvar o arquivo convertido.

O exemplo de código a seguir mostra como converter uma imagem JPG em um documento PDF usando uma API REST em Python.

# Este exemplo de código demonstra como converterer JPT em PDF.
# Crie instâncias de API necessárias
converter_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Preparar configurações de conversão
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertered"

# Solicitação de conversão
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# converter
result = converter_api.converter_document(request)

# Feito
print("Document convertered: " + result[0].path)
Converta JPG em PDF usando uma API REST em Python.

Converta JPG em PDF usando uma API REST em Python.

Baixe o PDF Convertido

O exemplo de código acima salvará o documento PDF convertido na nuvem. Ele pode ser baixado usando o seguinte exemplo de código:

# Este exemplo de código demonstra como baixar o arquivo PDF da nuvem.
# inicialização da API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# Solicitação de download de arquivo
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# ⇬ Fazer download do arquivo
response = file_api.download_file(request)

# Mova o arquivo baixado para o seu diretório de trabalho
shutil.move(response, "C:\\Files\\Conversion\\")

Conversão de JPG para PDF com opções avançadas

Podemos converter JPG para documento PDF com algumas configurações avançadas de forma programática, seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do ConvertApi.
  • Em seguida, crie uma instância do ConvertSettings.
  • Em seguida, defina o caminho do arquivo JPG.
  • E atribua “pdf” ao formato.
  • Além disso, forneça o caminho do arquivo de saída.
  • Em seguida, crie uma instância do PdfConvertOptions e atribua ao ConvertSettings.
  • Em seguida, defina várias configurações de conversão, como dpi, escala de cinza, imagem\qualidade, altura, margens (superior, esquerda, direita, inferior), etc.
  • Depois disso, crie ConvertDocumentRequest com ConvertSettings como argumento.
  • Por fim, chame o método ConvertApi.convert\document() com ConvertDocumentRequest para salvar o arquivo convertido.

O exemplo de código a seguir mostra como converter uma imagem JPG em um documento PDF com opções avançadas de conversão. Siga as etapas mencionadas anteriormente para carregar um arquivo de imagem JPG e baixar o arquivo PDF convertido.

# Este exemplo de código demonstra como converterer JPT em PDF com opções avançadas.
# Crie instâncias de API necessárias
converter_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Preparar configurações de conversão
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "convertered_with_options.pdf"

# Opções de conversão de PDF
converterOptions = groupdocs_conversion_cloud.PdfConvertOptions()
converterOptions.center_window = True
converterOptions.display_doc_title = True
converterOptions.dpi = 1024.0
converterOptions.fit_window = False
converterOptions.grayscale = True
converterOptions.image_quality = 100
converterOptions.linearize = True
converterOptions.margin_top = 500
converterOptions.margin_left = 500
converterOptions.margin_right = 500
converterOptions.margin_bottom = 500

settings.converter_options = converterOptions

# Solicitação de conversão
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# converter
result = converter_api.converter_document(request)

# Feito
print("Document convertered: " + result[0].path)
Conversão de JPG para PDF com opções avançadas.

Conversão de JPG para PDF com opções avançadas.

Converter JPG para PDF com marca d’água em Python

Podemos converter JPG em documento PDF e, em seguida, adicionar marca d’água ao PDF convertido programaticamente, seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do ConvertApi.
  • Em seguida, crie uma instância do ConvertSettings.
  • Em seguida, defina o caminho do arquivo JPG, atribua “pdf” ao formato e forneça o caminho do arquivo de saída.
  • Em seguida, crie uma instância do WatermarkOptions.
  • Em seguida, defina o texto da marca d’água, cor, fonte\tamanho, rotação\ângulo, etc.
  • Em seguida, crie uma instância do PdfConvertOptions e atribua ao WatermarkOptions.
  • Em seguida, defina opcionalmente várias configurações de conversão.
  • E atribua PdfConvertOptions ao arquivo ConvertSettings.
  • Depois disso, crie ConvertDocumentRequest com ConvertSettings como argumento.
  • Por fim, chame o método ConvertApi.convert\document() com ConvertDocumentRequest para salvar o arquivo convertido.

O exemplo de código a seguir mostra como converter JPG em um documento PDF e adicionar uma marca d’água ao documento PDF convertido usando uma API REST em Python.

# Este exemplo de código demonstra como converter JPT para PDF e adicionar marca d'água ao PDF convertido.
# Inicialização da API
convert_api = groupdocs_conversion_cloud.ConverterApi.from_keys(client_id, client_secret)

# Definir configurações de conversão
settings = groupdocs_conversion_cloud.ConverterSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# Definir opções de marca d'água
watermark = groupdocs_conversion_cloud.WatermarkOptions()
watermark.text = "THIS IS SAMPLE WATERMARK"
watermark.bold = True;
watermark.font_size = 34;
watermark.color = "Black";
watermark.background = False;
watermark.rotation_angle = 30;
watermark.left = 90;
watermark.top = 500;

# Definir opções de conversão de PDF
convertOptions = groupdocs_conversion_cloud.PdfConverterOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# Criar solicitação de conversão de documento
request = groupdocs_conversion_cloud.ConverterDocumentRequest(settings)
# Converter
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
Converta JPG para PDF com marca d'água em Python.

Converta JPG para PDF com marca d’água em Python.

Converta JPG para PDF e baixe o arquivo diretamente

Podemos converter JPG para PDF programaticamente e baixar o arquivo PDF convertido diretamente seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do ConvertApi.
  • Em seguida, crie uma instância do ConvertSettings.
  • Em seguida, defina o caminho do arquivo JPG.
  • E atribua “pdf” ao formato.
  • Além disso, forneça o caminho do arquivo de saída como Nenhum.
  • Depois disso, crie ConvertDocumentRequest com ConvertSettings como argumento.
  • Finalmente, chame o método ConvertApi.convert\document\download() com ConvertDocumentRequest para salvar o arquivo convertido no disco local.

O exemplo de código a seguir mostra como converter um arquivo de imagem JPG em um documento PDF e baixá-lo diretamente usando uma API REST em Python. A API deve retornar o arquivo PDF convertido em resposta. Siga as etapas mencionadas anteriormente para fazer upload de um arquivo.

# Este exemplo de código demonstra como converter e baixar.
# Crie instâncias de API necessárias
convert_api = groupdocs_conversion_cloud.ConverterApi.from_keys(client_id, client_secret)

# Preparar configurações de conversão
settings = groupdocs_conversion_cloud.ConverterSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

settings.output_path = None    # leave OutputPath will result the output as document IOStream

# Preparar pedido
request = groupdocs_conversion_cloud.ConverterDocumentRequest(settings)

# Converter
response = convert_api.convert_document_download(request)

# Mova o arquivo baixado para o seu diretório de trabalho
shutil.move(response, "C:\\Files\\Conversion\\")

Conversão de JPG para PDF sem usar armazenamento em nuvem

Podemos converter JPG para PDF sem usar o armazenamento em nuvem seguindo as etapas abaixo:

  • Em primeiro lugar, crie uma instância do ConvertApi
  • Em seguida, crie ConvertDocumentDirectRequest com o formato de destino e insira o caminho do arquivo de imagem como argumentos.
  • Em seguida, chame o método convert\document\direct() com ConvertDocumentDirectRequest como argumento.
  • Por fim, salve o arquivo PDF de saída convertido no caminho local usando o método FileStream.writeFile().

O exemplo de código a seguir mostra como converter JPG em um documento PDF sem usar o armazenamento em nuvem. Isso significa que passaremos o arquivo de entrada no corpo da solicitação e receberemos o arquivo de saída na resposta da API.

# Este exemplo de código demonstra como converter JPT para PDF sem usar o armazenamento em nuvem.
# Crie instâncias de API necessárias
convert_api = groupdocs_conversion_cloud.ConverterApi.from_keys(client_id, client_secret)

# Preparar pedido
request = groupdocs_conversion_cloud.ConverterDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# Converter
result = convert_api.convert_document_direct(request)

# Mova o arquivo baixado para o seu diretório de trabalho
shutil.move(result, "C:\\Files\\Conversion\\")

Experimente on-line

Experimente a seguinte ferramenta de conversão de JPG on-line gratuita, desenvolvida usando a API acima. https://products.groupdocs.app/conversion/

Conclusão

Neste artigo, aprendemos como converter um documento JPG em PDF na nuvem. Também vimos como converter JPG em PDF e adicionar marca d’água a documentos convertidos usando Python. Este artigo também explicou como carregar programaticamente um arquivo de imagem JPG para a nuvem e, em seguida, baixar o arquivo PDF convertido da nuvem. Além disso, você pode aprender mais sobre GroupDocs.Conversion Cloud API usando a documentação. Também fornecemos uma seção Referência de API que permite visualizar e interagir com nossas APIs diretamente pelo navegador. Em caso de ambiguidade, sinta-se à vontade para nos contatar no fórum.

Veja também