Konwertuj obrazy do formatu PDF za pomocą REST API w Python

PDF to jeden z popularnych formatów udostępniania i drukowania dokumentów. Często musimy konwertować dokumenty różnych formatów i obrazów do formatu PDF. Opracowanie takich narzędzi wymaga dużo czasu i wysiłku. Dlatego lepiej jest korzystać z już opracowanych specjalistycznych narzędzi, które zapewniają łatwe w utrzymaniu, elastyczne rozwiązanie dla Twoich potrzeb. W tym celu REST API do konwersji obrazów na PDF i Python SDK umożliwiają programową konwersję dokumentów w obsługiwanych formatach do formatu PDF w chmurze. W tym artykule dowiemy się, jak konwertować obrazy do formatu PDF za pomocą interfejsu API REST w Python.

W tym artykule zostaną omówione następujące tematy:

Konwersja obrazu do PDF REST API i Python SDK

Do konwersji obrazów JPG lub PNG na format PDF będziemy używać Python SDK of GroupDocs.Conversion Cloud API. Zainstaluj go za pomocą następującego polecenia w konsoli:

pip install groupdocs_converison_cloud

Proszę pobierz swój identyfikator klienta i klucz tajny z pulpitu nawigacyjnego przed wykonaniem wspomnianych kroków. Po uzyskaniu identyfikatora i tajnego kodu dodaj kod, jak pokazano poniżej:

# Ten przykład kodu demonstruje, jak ustawić identyfikator klienta i klucz tajny.
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 = ""

Konwertuj JPG na PDF za pomocą interfejsu API REST w Python

Możemy konwertować obrazy na dokumenty PDF, wykonując proste czynności podane poniżej:

  1. Prześlij plik obrazu JPG do chmury
  2. Konwertuj JPG na PDF przy użyciu Python
  3. Pobierz przekonwertowany plik PDF

Prześlij obraz

Najpierw prześlemy plik obrazu JPG do chmury, używając następującego przykładowego kodu:

# Ten przykład kodu pokazuje, jak przesłać plik obrazu JPG do chmury.
# Utwórz instancję interfejsu API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# prześlij prośbę o plik
request = groupdocs_conversion_cloud.UploadFileRequest("sample.jpg", "C:\\Files\\Conversion\\sample.jpg", my_storage)

# prześlij przykładowy plik
response = file_api.upload_file(request)

W rezultacie przesłany plik będzie dostępny w sekcji plików pulpitu nawigacyjnego w chmurze.

Konwertuj JPG na PDF za pomocą Python

Możemy programowo konwertować obrazy JPG na dokumenty PDF, wykonując następujące czynności:

  • Najpierw utwórz instancję ConvertApi.
  • Następnie utwórz instancję ConvertSettings.
  • Następnie ustaw ścieżkę pliku JPG.
  • I przypisz „pdf” do formatu.
  • Podaj również ścieżkę do pliku wyjściowego.
  • Następnie utwórz ConvertDocumentRequest z ConvertSettings jako argumentem.
  • Na koniec wywołaj metodę ConvertApi.convert\document() z ConvertDocumentRequest, aby zapisać przekonwertowany plik.

Poniższy przykładowy kod pokazuje, jak przekonwertować obraz JPG na dokument PDF przy użyciu interfejsu API REST w języku Python.

# Ten przykład kodu pokazuje, jak przekonwertować JPT na PDF.
# Utwórz niezbędne instancje interfejsu API
konwertować_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Przygotuj ustawienia konwersji
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "konwertowaćed"

# Żądanie konwersji
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# konwertować
result = konwertować_api.konwertować_document(request)

# Zrobione
print("Document konwertowaćed: " + result[0].path)
Konwertuj JPG na PDF za pomocą interfejsu API REST w Python.

Konwertuj JPG na PDF za pomocą interfejsu API REST w Python.

Pobierz przekonwertowany plik PDF

Powyższy przykładowy kod zapisze przekonwertowany dokument PDF w chmurze. Można go pobrać, korzystając z następującego przykładowego kodu:

# Ten przykład kodu pokazuje, jak pobrać plik PDF z chmury.
# Inicjalizacja interfejsu API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# Pobierz prośbę o plik
request = groupdocs_conversion_cloud.DownloadFileRequest("converted\\sample.pdf", my_storage)

# Pobieranie pliku
response = file_api.download_file(request)

# Przenieś pobrany plik do katalogu roboczego
shutil.move(response, "C:\\Files\\Conversion\\")

Konwersja JPG do PDF z opcjami zaawansowanymi

Możemy programowo przekonwertować dokument JPG na dokument PDF z niektórymi zaawansowanymi ustawieniami, wykonując czynności podane poniżej:

  • Najpierw utwórz instancję ConvertApi.
  • Następnie utwórz instancję ConvertSettings.
  • Następnie ustaw ścieżkę pliku JPG.
  • I przypisz „pdf” do formatu.
  • Podaj również ścieżkę do pliku wyjściowego.
  • Następnie utwórz instancję PdfConvertOptions i przypisz do ConvertSettings.
  • Następnie ustaw różne ustawienia konwersji, takie jak dpi, skala szarości, jakość obrazu, wysokość, marginesy (górny, lewy, prawy, dolny) itp.
  • Następnie utwórz ConvertDocumentRequest z ConvertSettings jako argumentem.
  • Na koniec wywołaj metodę ConvertApi.convert\document() z ConvertDocumentRequest, aby zapisać przekonwertowany plik.

Poniższy przykład kodu pokazuje, jak przekonwertować obraz JPG na dokument PDF z zaawansowanymi opcjami konwersji. Wykonaj czynności wymienione wcześniej, aby przesłać plik obrazu JPG i pobrać przekonwertowany plik PDF.

# Ten przykład kodu pokazuje, jak przekonwertować JPT na PDF z opcjami zaawansowanymi.
# Utwórz niezbędne instancje interfejsu API
konwertować_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# Przygotuj ustawienia konwersji
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "konwertowaćed_with_options.pdf"

# Opcje konwersji PDF
konwertowaćOptions = groupdocs_conversion_cloud.PdfConvertOptions()
konwertowaćOptions.center_window = True
konwertowaćOptions.display_doc_title = True
konwertowaćOptions.dpi = 1024.0
konwertowaćOptions.fit_window = False
konwertowaćOptions.grayscale = True
konwertowaćOptions.image_quality = 100
konwertowaćOptions.linearize = True
konwertowaćOptions.margin_top = 500
konwertowaćOptions.margin_left = 500
konwertowaćOptions.margin_right = 500
konwertowaćOptions.margin_bottom = 500

settings.konwertować_options = konwertowaćOptions

# Żądanie konwersji
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# konwertować
result = konwertować_api.konwertować_document(request)

# Zrobione
print("Document konwertowaćed: " + result[0].path)
Konwersja JPG do PDF z opcjami zaawansowanymi.

Konwersja JPG do PDF z opcjami zaawansowanymi.

Konwertuj JPG na PDF ze znakiem wodnym w Python

Możemy przekonwertować JPG na dokument PDF, a następnie programowo dodać znak wodny do przekonwertowanego pliku PDF, wykonując czynności podane poniżej:

  • Najpierw utwórz instancję ConvertApi.
  • Następnie utwórz instancję ConvertSettings.
  • Następnie ustaw ścieżkę pliku JPG, przypisz „pdf” do formatu i podaj ścieżkę pliku wyjściowego.
  • Następnie utwórz instancję WatermarkOptions.
  • Następnie ustaw tekst znaku wodnego, kolor, rozmiar czcionki, kąt obrotu itp.
  • Następnie utwórz instancję PdfConvertOptions i przypisz do WatermarkOptions.
  • Następnie opcjonalnie ustaw różne ustawienia konwersji.
  • I przypisz PdfConvertOptions do pliku ConvertSettings.
  • Następnie utwórz ConvertDocumentRequest z ConvertSettings jako argumentem.
  • Na koniec wywołaj metodę ConvertApi.convert\document() z ConvertDocumentRequest, aby zapisać przekonwertowany plik.

Poniższy przykład kodu pokazuje, jak przekonwertować plik JPG na dokument PDF i dodać znak wodny do przekonwertowanego dokumentu PDF przy użyciu interfejsu API REST w języku Python.

# Ten przykład kodu pokazuje, jak przekonwertować JPT na PDF i dodać znak wodny do przekonwertowanego pliku PDF.
# Inicjalizacja interfejsu API
convert_api = groupdocs_conversion_cloud.KonwertowaćApi.from_keys(client_id, client_secret)

# Zdefiniuj ustawienia konwersji
settings = groupdocs_conversion_cloud.KonwertowaćSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"
settings.output_path = "converted"

# Zdefiniuj opcje znaku wodnego
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;

# Zdefiniuj opcje konwersji PDF
convertOptions = groupdocs_conversion_cloud.PdfKonwertowaćOptions()
convertOptions.watermark_options = watermark

settings.convert_options = convertOptions

# Utwórz żądanie konwersji dokumentu
request = groupdocs_conversion_cloud.KonwertowaćDocumentRequest(settings)
# Konwertować
result = convert_api.convert_document(request)
print("Document converted successfully: " + result[0].url)
Konwertuj JPG na PDF ze znakiem wodnym w Python.

Konwertuj JPG na PDF ze znakiem wodnym w Python.

Konwertuj JPG na PDF i bezpośrednio pobierz plik

Możemy programowo przekonwertować JPG na PDF i pobrać przekonwertowany plik PDF bezpośrednio, wykonując czynności podane poniżej:

  • Najpierw utwórz instancję ConvertApi.
  • Następnie utwórz instancję ConvertSettings.
  • Następnie ustaw ścieżkę pliku JPG.
  • I przypisz „pdf” do formatu.
  • Podaj również ścieżkę pliku wyjściowego jako Brak.
  • Następnie utwórz ConvertDocumentRequest z ConvertSettings jako argumentem.
  • Na koniec wywołaj metodę ConvertApi.convert\document\download() z ConvertDocumentRequest, aby zapisać przekonwertowany plik na dysku lokalnym.

Poniższy przykładowy kod pokazuje, jak przekonwertować plik obrazu JPG na dokument PDF i pobrać go bezpośrednio przy użyciu interfejsu API REST w języku Python. W odpowiedzi API zwróci przekonwertowany plik PDF. Wykonaj czynności wymienione wcześniej, aby przesłać plik.

# Ten przykład kodu demonstruje sposób ukrywania i pobierania.
# Utwórz niezbędne instancje interfejsu API
convert_api = groupdocs_conversion_cloud.KonwertowaćApi.from_keys(client_id, client_secret)

# Przygotuj ustawienia konwersji
settings = groupdocs_conversion_cloud.KonwertowaćSettings()
settings.file_path = "sample.jpg"
settings.format = "pdf"

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

# Przygotuj wniosek
request = groupdocs_conversion_cloud.KonwertowaćDocumentRequest(settings)

# Konwertować
response = convert_api.convert_document_download(request)

# Przenieś pobrany plik do katalogu roboczego
shutil.move(response, "C:\\Files\\Conversion\\")

Konwersja JPG do PDF bez korzystania z Cloud Storage

Możemy przekonwertować JPG na PDF bez korzystania z przechowywania w chmurze, wykonując czynności podane poniżej:

  • Najpierw utwórz instancję ConvertApi
  • Następnie utwórz ConvertDocumentDirectRequest z formatem docelowym i ścieżką pliku obrazu wejściowego jako argumentami.
  • Następnie wywołaj metodę convert\document\direct() z ConvertDocumentDirectRequest jako argumentem.
  • Na koniec zapisz przekonwertowany wyjściowy plik PDF w ścieżce lokalnej za pomocą metody FileStream.writeFile().

Poniższy przykładowy kod pokazuje, jak przekonwertować plik JPG na dokument PDF bez korzystania z magazynu w chmurze. Oznacza to, że przekażemy plik wejściowy w treści żądania i otrzymamy plik wyjściowy w odpowiedzi API.

# Ten przykład kodu pokazuje, jak przekonwertować JPT na PDF bez korzystania z magazynu w chmurze.
# Utwórz niezbędne instancje interfejsu API
convert_api = groupdocs_conversion_cloud.KonwertowaćApi.from_keys(client_id, client_secret)

# Przygotuj wniosek
request = groupdocs_conversion_cloud.KonwertowaćDocumentDirectRequest("pdf", "C:\\Files\\Conversion\\sample.jpg")

# Konwertować
result = convert_api.convert_document_direct(request)

# Przenieś pobrany plik do katalogu roboczego
shutil.move(result, "C:\\Files\\Conversion\\")

Wypróbuj online

Wypróbuj następujące bezpłatne narzędzie online do konwersji JPG, które zostało opracowane przy użyciu powyższego interfejsu API. https://products.groupdocs.app/conversion/

Wniosek

W tym artykule dowiedzieliśmy się, jak przekonwertować plik JPG na dokument PDF w chmurze. Widzieliśmy również, jak przekonwertować JPG na PDF i dodać znak wodny do przekonwertowanych dokumentów za pomocą Python. W tym artykule wyjaśniono również, jak programowo przesłać plik obrazu JPG do chmury, a następnie pobrać przekonwertowany plik PDF z chmury. Poza tym możesz dowiedzieć się więcej o GroupDocs.Conversion Cloud API korzystając z dokumentacji. Udostępniamy również sekcję Informacje o interfejsach API, która umożliwia wizualizację i interakcję z naszymi interfejsami API bezpośrednio w przeglądarce. W przypadku jakichkolwiek niejasności prosimy o kontakt na forum.

Zobacz też