全部產品
Search

搜尋本產品

    Object Storage Service：Python圖片處理

    文件中心

    Object Storage Service：Python圖片處理

    更新時間：Oct 26, 2024

    圖片處理是OSS提供的海量、安全、低成本、高可靠的圖片處理服務。原始圖片上傳到OSS後，您可以通過簡單的RESTful介面，在任何時間、任何地點、任何互連網裝置上對圖片進行處理。

    關於圖片處理支援的參數，請參見處理參數。

    注意事項

    • 本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS訪問網域名稱、資料中心、開放連接埠。

    • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient，請參見初始化。

    使用圖片處理參數處理圖片

    • 使用單個圖片處理參數處理圖片並儲存為本地圖片

      # -*- coding: utf-8 -*-
import os
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"

# examplebucket填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

# yourObjectName填寫靶心圖表片名稱。若圖片不在Bucket根目錄，需攜帶檔案訪問路徑，例如example/example.jpg。
key = 'yourObjectName'
# LocalFileName填寫處理後的圖片名稱。
new_pic = 'LocalFileName'

# 若靶心圖表片不在指定Bucket內，需上傳圖片到目標Bucket。
# bucket.put_object_from_file(key, 'yourLocalFile')

# 將圖片縮放為固定寬高100 px後儲存到本地。
style = 'image/resize,m_fixed,w_100,h_100'
bucket.get_object_to_file(key, new_pic, process=style)

# 圖片處理完成後，若Bucket內的原圖不再需要，可以刪除原圖。
# bucket.delete_object(key)
# 若處理後的圖片不再需要，可以刪除處理後的圖片。
# os.remove(new_pic)

    • 使用多個圖片處理參數處理圖片並儲存為本地圖片

      使用多個圖片處理參數處理圖片時，多個參數之間以正斜線（/）分隔。

      # -*- coding: utf-8 -*-
import os
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"

# examplebucket填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

# 指定原圖所在的Bucket名稱，例如examplebucket。
bucket_name = 'examplebucket'
# 指定原圖名稱。如果圖片不在Bucket根目錄，需攜帶圖片完整路徑，例如exampledir/example.jpg。
key = 'exampledir/example.jpg'
# 指定處理後的圖片名稱。
new_pic = 'exampledir/newexample.jpg'

# 如果圖片不在指定Bucket內，需將本地路徑下的圖片上傳到指定Bucket。
# bucket.put_object_from_file(key, 'D:\\localpath\\example.jpg')

# 將圖片縮放為固定寬高100 px後，再旋轉90°，之後儲存至本地。
style = 'image/resize,m_fixed,w_100,h_100/rotate,90'
bucket.get_object_to_file(key, new_pic, process=style)
# 圖片處理完成後，若Bucket內的原圖不再需要，可以刪除原圖。
# bucket.delete_object(key)
# 如果處理後的圖片不再需要，可以刪除處理後的圖片。
# os.remove(new_pic)

    使用圖片樣式處理圖片

    您可以將多個圖片處理參數封裝在一個樣式中，之後使用樣式批量處理圖片。更多資訊，請參見圖片樣式。以下代碼展示了使用圖片樣式處理圖片：

    # -*- coding: utf-8 -*-
import os
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"

# examplebucket填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

# 指定原圖所在的Bucket名稱，例如examplebucket。
bucket_name = 'examplebucket'
# 指定原圖名稱。如果圖片不在Bucket根目錄，需攜帶圖片完整路徑，例如exampledir/example.jpg。
key = 'exampledir/example.jpg'
# 指定處理後的圖片名稱。
new_pic = 'exampledir/newexample.jpg'

# 如果圖片不在指定Bucket內，需將本地路徑下的圖片上傳到指定Bucket。
# bucket.put_object_from_file(key, 'D:\\localpath\\example.jpg')

# 使用自訂樣式處理圖片。其中，yourCustomStyleName填寫通過OSS管理主控台建立的圖片樣式名稱。
style = 'style/yourCustomStyleName'
# 將處理後的圖片儲存在本地。
bucket.get_object_to_file(key, new_pic, process=style)
# 圖片處理完成後，如果Bucket內的原圖不再需要，可將其刪除。
# bucket.delete_object(key)
# 如果處理後的圖片不再需要，可將其刪除。
# os.remove(new_pic)

    圖片處理持久化

    您可以通過ImgSaveAs介面將處理後的圖片儲存至指定Bucket。以下代碼展示了圖片處理持久化操作： 

    # -*- coding: utf-8 -*-
import os
import base64
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"

# examplebucket填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

# 指定原圖所在的Bucket名稱。
source_bucket_name = 'srcbucket'
# 指定用於存放處理後圖片的Bucket名稱，該Bucket需與原圖所在Bucket在同一地區。
target_bucket_name = 'destbucket'
# 指定原圖名稱。如果圖片不在Bucket根目錄，需攜帶檔案完整訪問路徑，例如example/example.jpg。
source_image_name = 'example/example.jpg'

# 將圖片縮放為固定寬高100 px。
style = 'image/resize,m_fixed,w_100,h_100'
# 指定處理後圖片名稱。如果圖片不在Bucket根目錄，需攜帶檔案完整訪問路徑，例如exampledir/example.jpg。
target_image_name = 'exampledir/example.jpg'
process = "{0}|sys/saveas,o_{1},b_{2}".format(style,
    oss2.compat.to_string(base64.urlsafe_b64encode(oss2.compat.to_bytes(target_image_name))),
    oss2.compat.to_string(base64.urlsafe_b64encode(oss2.compat.to_bytes(target_bucket_name))))
result = bucket.process_object(source_image_name, process)
print(result)

    產生帶圖片處理參數的檔案簽名URL

    私人檔案的訪問URL帶有簽名。OSS不支援在帶簽名的URL後直接添加圖片處理參數。如果您想要對私人檔案進行圖片處理，需要將圖片處理參數加入到簽名中，相關的程式碼範例如下：

    # -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# 填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數
region = "cn-hangzhou"

# examplebucket填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)

# 填寫Bucket名稱，例如examplebucket。
bucket_name = 'examplebucket'
# 指定圖片所在Bucket的名稱。如果圖片不在Bucket根目錄，需攜帶檔案完整路徑，例如exampledir/example.jpg。
key = 'exampledir/example.jpg'

# 如果圖片不在指定Bucket內，需將該圖片到目標Bucket。
# bucket.put_object_from_file(key, 'D:\\localpath\\example.jpg')
# 將圖片縮放為固定寬高100 px後，再旋轉90°。
style = 'image/resize,m_fixed,w_100,h_100/rotate,90'
# 產生帶簽名的URL，並指定到期時間為10分鐘。到期時間單位為秒。
url = bucket.sign_url('GET', key, 10 * 60, params={'x-oss-process': style})
print(url)

    相關文檔

    關於圖片處理的完整代碼，請參見GitHub樣本。