調用API將多張圖片合并為單個PDF-Intelligent Media Management-阿里雲

圖片轉換為PDF檔案可以將多張圖片轉換為單個PDF檔案，為使用者提供方便的檔案尋找服務。本文介紹如何使用圖片轉換為PDF檔案功能。

使用情境

文檔共用：使用者需要發送多張圖片時，將它們合并為一個PDF檔案更為方便。
列印準備：將圖片轉換為PDF格式可以確保在列印時檔案的布局和格式保持不變。
跨平台相容性：PDF是一種跨平台的檔案格式，能夠在不同的作業系統中保持一致的顯示效果，不論是Windows、macOS還是Linux。

前提條件

已建立並擷取AccessKey。具體操作，請參見建立AccessKey。
已開通OSS服務、建立儲存空間並上傳檔案到儲存空間。具體操作，請參見控制台上傳檔案。
已開通Intelligent Media Management服務。具體操作，請參見開通產品。
已通過Intelligent Media Management控制台建立專案。具體操作，請參見建立專案。
說明
- 您也可以調用API介面建立專案。具體操作，請參見CreateProject - 建立專案。
- 您可以調用ListProjects - 列出所有專案資訊的列表介面列出指定地區下已建立的所有專案資訊。

使用方法

調用CreateImageToPDFTask - 建立圖片轉PDF任務介面將多張圖片轉換為單個PDF檔案。

重要

任務開始執行後，任務資訊只儲存7天，超過7天則無法再擷取。您可以通過以下幾種方式及時擷取任務資訊：

調用GetTask - 擷取任務資訊或ListTasks - 列出任務介面擷取返回的TaskId，查看任務資訊。
在與Intelligent Media Management相同的地區下開通MNS服務，並配置訂閱關係，及時擷取任務資訊通知，非同步通知訊息格式請參見非同步通知訊息格式。關於MNS SDK的更多資訊，請參見步驟四：接收和刪除訊息。
在與Intelligent Media Management相同的地區下開通RocketMQ服務，並建立RocketMQ 4.0執行個體、Topic、Group，及時擷取任務資訊通知，非同步通知訊息格式請參見非同步通知訊息格式。關於RocketMQ使用的更多資訊，請參見調用HTTP協議的SDK收發普通訊息。
在與Intelligent Media Management相同的地區下開通並接入事件匯流排EventBridge服務，及時擷取任務資訊通知。更多資訊，請參見Intelligent Media ManagementIMM事件。

轉換資訊

IMM專案名稱：test-project
圖片的儲存地址：oss://test-bucket/test-object.jpg
轉換後的PDF檔案儲存體地址：oss://test-bucket/test-target-object.pdf

請求樣本

{
    "ProjectName": "test-project",
    "Sources": "[{\"URI\": \"oss://test-bucket/test-object.jpg\"}]",
    "TargetURI": "oss://test-bucket/test-target-object.pdf",
}

返回樣本

{
    "TaskId": "ImageToPDF-1c73b551-381d-46cc-86ed-16905*****",
    "RequestId": "657DE82D-5960-0309-810C-639637*****",
    "EventId": "124-1S7JgMQdZ3kWQbmUqXxI3******"
}

範例程式碼

以Python SDK為例，圖片轉換為PDF檔案的完整範例程式碼如下。

# -*- coding: utf-8 -*-
# This file is auto-generated, don't edit it. Thanks.
import sys
import os
from typing import List

from alibabacloud_imm20200930.client import Client as imm20200930Client
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_imm20200930 import models as imm_20200930_models
from alibabacloud_tea_util import models as util_models
from alibabacloud_tea_util.client import Client as UtilClient


class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client(
        access_key_id: str,
        access_key_secret: str,
    ) -> imm20200930Client:
        """
        使用AccessKey ID&AccessKey Secret初始化帳號Client。
        @param access_key_id:
        @param access_key_secret:
        @return: Client
        @throws Exception
        """
        config = open_api_models.Config(
            access_key_id=access_key_id,
            access_key_secret=access_key_secret
        )
        # 填寫訪問的IMM網域名稱。
        config.endpoint = f'imm.cn-zhangjiakou.aliyuncs.com'
        return imm20200930Client(config)

    @staticmethod
    def main(
        args: List[str],
    ) -> None:
        # 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
        # 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
        # 本樣本通過從環境變數中讀取AccessKey，來實現API訪問的身分識別驗證。如何配置環境變數，請參見https://www.alibabacloud.com/help/document_detail/2361894.html。
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        sources_0 = imm_20200930_models.CreateImageToPDFTaskRequestSources(
            uri='oss://test-bucket/test-object.jpg'
        )
        create_image_to_pdftask_request = imm_20200930_models.CreateImageToPDFTaskRequest(
            project_name='test-project',
            target_uri='oss://test-bucket/test-target-object.pdf',
            sources=[
                sources_0
            ]
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 複製代碼運行請自行列印API的傳回值。
            client.create_image_to_pdftask_with_options(create_image_to_pdftask_request, runtime)
        except Exception as error:
            # 如有需要，請列印錯誤資訊。
            UtilClient.assert_as_string(error.message)

    @staticmethod
    async def main_async(
        args: List[str],
    ) -> None:
        # 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
        # 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
        # 本樣本通過從環境變數中讀取AccessKey，來實現API訪問的身分識別驗證。如何配置環境變數，請參見https://www.alibabacloud.com/help/document_detail/2361894.html。
        imm_access_key_id = os.getenv("AccessKeyId")
        imm_access_key_secret = os.getenv("AccessKeySecret")
        client = Sample.create_client(imm_access_key_id, imm_access_key_secret)
        sources_0 = imm_20200930_models.CreateImageToPDFTaskRequestSources(
            uri='oss://test-bucket/test-object.jpg'
        )
        create_image_to_pdftask_request = imm_20200930_models.CreateImageToPDFTaskRequest(
            project_name='test-project',
            target_uri='oss://test-bucket/test-target-object.pdf',
            sources=[
                sources_0
            ]
        )
        runtime = util_models.RuntimeOptions()
        try:
            # 複製代碼運行請自行列印API的傳回值。
            await client.create_image_to_pdftask_with_options_async(create_image_to_pdftask_request, runtime)
        except Exception as error:
            # 如有需要，請列印錯誤資訊。
            UtilClient.assert_as_string(error.message)


if __name__ == '__main__':
    Sample.main(sys.argv[1:])

計費說明

在圖片轉換為 PDF 過程中，OSS 和 IMM 兩側會產生以下計費項目：

OSS 側：詳細定價請參見OSS產品定價

API	計費項目	說明
GetObject	GET 類型請求	根據成功的請求次數計算請求費用。
	低頻訪問資料取回容量	如果取回的資料是低頻訪問資料，會產生低頻訪問資料取回容量的費用，按資料取回量計費。
	歸檔直讀資料取回容量	如果讀取的是歸檔的Object且Bucket開啟了歸檔直讀，會產生歸檔直讀資料取回容量費用，根據取回的資料容量大小計費。
	傳輸加速	如果開啟了傳輸加速功能且使用傳輸加速網域名稱訪問您的Bucket會產生傳輸加速費用，根據資料容量大小計費。
PutObject	PUT類型請求	根據成功的請求次數計算請求費用。
PutObject	儲存費用	根據Object的儲存類型、大小和時間長度收取儲存費用。
HeadObject	GET 類型請求	根據成功的請求次數計算請求費用。

IMM 側：詳細定價請參見IMM計費項目。
重要
自北京時間 2025 年 7 月 28 日 11:00 起，IMM 圖片轉PDF服務將由免費模式升級為計費模式，更多資訊請參見IMM計費調整公告。
API
計費項目
說明
CreateImageToPDFTask
ImageToPDF
根據圖片轉換數量計算圖片轉PDF的費用。

API	計費項目	說明
CreateImageToPDFTask	ImageToPDF	根據圖片轉換數量計算圖片轉PDF的費用。