如何在 Python 中執行 HTML 到 PPT 的轉換

Fri, 16 Oct 2026 12:47:14 +0000

從網頁內容建立投影片套件是報告工具和自動化簡報產生器的常見需求。 GroupDocs.Conversion Cloud SDK for Python 讓開發人員能夠完全在雲端執行文件轉換，無需本機依賴。在本指南中，我們將演示如何在 Python 中將 HTML 轉換為 PPT，說明如何配置 SDK、執行轉換以及取得最終的 PPTX 檔案。您還將看到等效的 cURL 呼叫以及微調輸出的選項。

HTML 轉 PPT 的需求

開發報告儀表板的開發人員通常需要將動態 HTML 頁面轉換為可與利害關係人共享的 PowerPoint 簡報。來源 HTML 可能包含樣式化的表格、圖像和自訂字型，生成的 PPTX 必須保留版面配置的忠實度，同時可在 Microsoft PowerPoint 中進一步編輯。由於轉換必須在沒有圖形使用者介面的伺服器上執行，因此需要一個能與雲端儲存配合的程式化解決方案。

關鍵技術需求包括：

訪問存儲在 GroupDocs Cloud 的 HTML 文件。
能夠指定 PPTX‑特定的選項，例如幻燈片大小或密碼保護。
一種可靠的方式來檢索已轉換的文件，以便進行下游處理或下載。

手動複製‑貼上或桌面工具無法在大規模下滿足這些限制，尤其是當工作流程需要整合到自動化管道時。

為此工作選擇 GroupDocs.Conversion Cloud SDK for Python

GroupDocs.Conversion Cloud SDK for Python 提供基於 REST 的 API，無需本地安裝即可處理格式轉換。該 SDK 支援廣泛的來源和目標格式，包括 HTML → PPTX，並通過 ConvertSettings 和 PptxConvertOptions 類提供細緻的轉換設定。其雲端優先架構意味著您可以將輸入檔案存儲在 GroupDocs storage，於伺服器上執行轉換，並從您的 Python 程式碼中下載結果。

SDK 的文件非常完整（官方文档），API 参考详细说明了您将使用的每个类和方法（API 参考）。您可以从发布页面下载最新的套件（下载链接），并在几分钟内开始构建转换功能。

在 Python 中實作程式化 HTML 到 PPT 的轉換

安裝 SDK

SDK 透過 PyPI 發佈。使用標準套件管理員安裝它：

pip install groupdocs-conversion-cloud

配置 API 客戶端

建立配置物件並提供您的客戶端憑證。這些值是每個 API 呼叫所必需的。

import groupdocs_conversion_cloud
from groupdocs_conversion_cloud import Configuration, ApiClient, ConvertApi

config = Configuration()
config.api_key['client_id'] = 'YOUR_CLIENT_ID'          # replace with your client id
config.api_key['client_secret'] = 'YOUR_CLIENT_SECRET'  # replace with your client secret

api_client = ApiClient(config)
convert_api = ConvertApi(api_client)

定義輸入 HTML 檔案

指定位於 GroupDocs Cloud 儲存中的 HTML 檔案。如有需要，您也可以指向自訂儲存位置。

from groupdocs_conversion_cloud import FileInfo

input_file = FileInfo()
input_file.file_path = "sample.html"   # HTML file stored in GroupDocs Cloud storage
# input_file.storage_name = "MyStorage"  # optional: specify a custom storage

設定 PPTX 轉換選項

建立一個 PptxConvertOptions 實例。您可以取消註解並調整屬性，例如密碼保護。

from groupdocs_conversion_cloud import PptxConvertOptions

pptx_options = PptxConvertOptions()
# pptx_options.password = "myPassword"   # example of setting a password

執行轉換

將檔案資訊、格式、輸出路徑和選項組合成一個 ConvertSettings 物件，然後呼叫 API。

from groupdocs_conversion_cloud import ConvertSettings

settings = ConvertSettings()
settings.file_info = input_file
settings.format = "pptx"                # target format
settings.output_path = "converted.pptx" # output file name in storage
settings.options = pptx_options

try:
    result = convert_api.convert_document(settings)
    if isinstance(result, list):
        for item in result:
            print(f"Converted file stored at: {item.path}")
    else:
        print(f"Converted file stored at: {result.path}")
except groupdocs_conversion_cloud.ApiException as ex:
    print("Error during conversion:", ex)

完成這些步驟後，Python 中的 HTML 轉 PPT 轉換已完成，生成的 PPTX 檔案已可在您的雲端儲存中取得。

完整程式碼範例：使用 GroupDocs.Conversion 自動將 HTML 轉換為 PPT

以下程式碼示範完整的端對端流程。

import groupdocs_conversion_cloud
from groupdocs_conversion_cloud import (
    Configuration,
    ApiClient,
    ConvertApi,
    FileInfo,
    ConvertSettings,
    PptxConvertOptions,
)

def main():
    # -------------------- Configuration --------------------
    config = Configuration()
    config.api_key['client_id'] = 'YOUR_CLIENT_ID'          # replace with your client id
    config.api_key['client_secret'] = 'YOUR_CLIENT_SECRET'  # replace with your client secret

api_client = ApiClient(config)
    convert_api = ConvertApi(api_client)

# -------------------- Input File --------------------
    input_file = FileInfo()
    input_file.file_path = "sample.html"   # HTML file stored in GroupDocs Cloud storage
    # input_file.storage_name = "MyStorage"  # optional: specify a custom storage

# -------------------- Conversion Options --------------------
    pptx_options = PptxConvertOptions()
    # Example of setting an option (uncomment if needed)
    # pptx_options.password = "myPassword"

# -------------------- Conversion Settings --------------------
    settings = ConvertSettings()
    settings.file_info = input_file
    settings.format = "pptx"                # target format
    settings.output_path = "converted.pptx" # output file name in storage
    settings.options = pptx_options

# -------------------- Perform Conversion --------------------
    try:
        result = convert_api.convert_document(settings)
        # The API returns a list of converted files; each item has a 'path' attribute
        if isinstance(result, list):
            for item in result:
                print(f"Converted file stored at: {item.path}")
        else:
            print(f"Converted file stored at: {result.path}")
    except groupdocs_conversion_cloud.ApiException as ex:
        print("Error during conversion:", ex)

if __name__ == "__main__":
    main()

注意： 此程式碼範例展示了核心功能。在將其用於您的專案之前，請確保更新所有檔案路徑和設定值以符合實際環境，驗證所有必要的相依項目已正確安裝，並在開發環境中徹底測試。若遇到任何問題，請參閱官方文件或聯繫支援團隊以獲得協助。

使用 cURL 和 REST API 將 HTML 轉換為 PPT

如果您更喜歡直接使用 REST 端點，則可以使用 cURL 命令執行相同的轉換。

驗證並取得存取權杖
將佔位符替換為您的憑證。

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

上傳來源 HTML 檔案

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.html" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/html" \
     --data-binary @sample.html

執行轉換

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.html" },
           "format": "pptx",
           "outputPath": "converted.pptx",
           "options": {}
         }'

下載輸出 PPTX 檔案

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/converted.pptx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o converted.pptx

如需完整的參數清單和進階設定，請參閱官方 API 文件。

微調 HTML 轉 PPT 的轉換選項

SDK 提供了多個選項，您可以通過 PptxConvertOptions 類進行調整。

密碼保護 - 使用密碼保護生成的 PPTX。

pptx_options.password = "mySecurePassword"

Slide Size - 定義每張投影片的尺寸（例如，Standard、Widescreen）。
請參考 API 參考以獲取確切的列舉值。
Image Quality - 控制嵌入演示文稿的圖像的壓縮級別。
更高的品質會導致更大的文件。

這些選項讓您可以根據特定的展示標準或公司政策調整輸出。

總結

在 Python 中使用 GroupDocs.Conversion Cloud SDK for Python 進行 HTML 轉 PPT 變得簡單。按照上述步驟，您可以自動從網頁內容生成 PowerPoint 簡報，將此流程整合到後端服務中，並在無需人工干預的情況下處理大量資料。請務必保護您的 API 憑證，使用具代表性的 HTML 範例測試轉換，並探索其他選項以微調輸出。對於正式環境的部署，您需要有效的授權；您可以從授權頁面獲取臨時授權，並隨著使用量的增長升級至付費方案。

常見問題

在 Python 中，使用 GroupDocs.Conversion 進行 HTML 到 PPT 轉換的工作原理是什麼？
SDK 從您的 GroupDocs Cloud 儲存空間讀取 HTML 檔案，套用 PPTX 轉換設定，並返回可透過 API 下載的 PPTX 檔案。整個過程在雲端執行，無需本機安裝 PowerPoint。

我可以在 Python 中自動化將 HTML 轉換為 PPT，針對多個檔案嗎？
是的。只要將轉換邏輯放入迴圈，並提供不同的 file_path 值，即可以程式方式批次處理 HTML 檔案。SDK 會獨立處理每個請求，並將結果儲存回雲端儲存。

HTML 轉 PPT 在 Python 中有哪些轉換選項？
您可以透過 PptxConvertOptions 類別設定密碼保護、投影片尺寸、影像品質等。詳細資訊請參閱 API 參考。

我需要 GroupDocs.Conversion Cloud SDK for Python 的授權嗎？
在生產環境中需要授權。您可以從臨時授權頁面獲取臨時授權，之後再購買與您的使用量相匹配的完整授權。

python presentation conversion on Document Processing REST APIs | GroupDocs Cloud