图片处理是OSS提供的海量、安全、低成本、高可靠的图片处理服务。原始图片上传到OSS后，您可以通过简单的RESTful接口，在任何时间、任何地点、任何互联网设备上对图片进行处理。

图片处理的详细信息请参见OSS图片处理指南。

图片处理功能

OSS图片处理提供以下功能：

图片处理使用

图片处理使用标准的HTTP GET请求。您可以在URL的QueryString中设置处理参数。

如果图片文件的访问权限为私有读写，必须通过授权才能进行访问。

  • 匿名访问您可以通过如下格式的三级域名匿名访问处理后的图片：
  1. http://<yourBucketName>.<yourEndpoint>/<yourObjectName>?x-oss-process=image/<yourAction>,<yourParamValue>

参数描述bucket存储空间名称endpoint存储空间所在地域的访问域名object图片文件名称image图片处理的保留标志符action对图片做的操作，如缩放、裁剪、旋转等param对图片做的操作所对应的参数

  • 基础操作例如，将图缩略成宽度为100，高度按比例处理：
  1. http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100
  • 自定义样式使用如下格式的三级域名匿名访问图片处理：
  1. http://<yourBucketName>.<yourEndpoint>/<yourObjectName>?x-oss-process=style/<yourStyleName>
  1. - style：自定义样式的保留标志符。
  2. - yourStyleName：自定义样式名称，即通过控制台自定义样式的规则名称。

例如：

  1. http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/oss-pic-style-w-100
  • 级联处理通过级联处理，可以对一张图片顺序进行多个操作，格式如下：
  1. http://<yourBucketName>.<yourEndpoint>/<yourObjectName>?x-oss-process=image/<yourAction1>,<yourParamValue1>/<yourAction2>,<yourParamValue2>/...

例如：

  1. http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100/rotate,90
  • 支持HTTPS访问图片服务支持HTTPS访问，例如：
  1. https://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100
  • 授权访问授权访问支持自定义样式、HTTPS和级联处理。以下代码用于生成带签名的图片处理URL：
  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func HandleError(err error) {
  10.     fmt.Println("Error:", err)
  11.     os.Exit(-1)
  12. }
  14. func main() {
  15.     // 创建OSSClient实例。
  16.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  17.     if err != nil {
  18.     HandleError(err)
  19.     }
  21.     // 获取存储空间。
  22.     bucketName := "<yourBucketName>"
  23.     bucket, err := client.Bucket(bucketName)
  24.     if err != nil {
  25.     HandleError(err)
  26.     }
  28.     ossImageName := "<yourImageName>"
  29.     signedURL, err := bucket.SignURL(ossImageName, oss.HTTPGet, 600, oss.Process("image/format,png"))
  30.     if err != nil {
  31.     HandleError(err)
  32.     } else {
  33.     fmt.Println(signedURL)
  34.     }
  35. }

  • SDK访问对于任意权限的图片文件，都可以直接使用SDK访问和处理。SDK处理图片文件支持自定义样式、HTTPS和级联处理。

  • 基础操作以下代码展示了图片处理的基础操作：

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func HandleError(err error) {
  10.     fmt.Println("Error:", err)
  11.     os.Exit(-1)
  12. }
  14. func main() {
  15.     // 创建OSSClient实例。
  16.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  17.     if err != nil {
  18.     HandleError(err)
  19.     }
  21.     // 获取存储空间。
  22.     bucketName := "<yourBucketName>"
  23.     bucket, err := client.Bucket(bucketName)
  24.     if err != nil {
  25.     HandleError(err)
  26.     }
  28.     // 图片处理：缩放。
  29.     sourceImageName := "example.png"
  30.     targetImageName := "example-resize.png"
  31.     style := "image/resize,m_fixed,w_100,h_100"
  32.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  33.     if err != nil {
  34.     HandleError(err)
  35.     }
  37.     // 图片处理：裁剪。
  38.     targetImageName = "example-crop.png"
  39.     style = "image/crop,w_100,h_100,x_100,y_100,r_1"
  40.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  41.     if err != nil {
  42.     HandleError(err)
  43.     }
  45.     // 图片处理：旋转。
  46.     targetImageName = "example-rotate.png"
  47.     style = "image/rotate,90"
  48.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  49.     if err != nil {
  50.     HandleError(err)
  51.     }
  53.     // 图片处理：锐化。
  54.     targetImageName = "example-sharpen.png"
  55.     style = "image/sharpen,100"
  56.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  57.     if err != nil {
  58.     HandleError(err)
  59.     }
  61.     // 图片处理：水印。
  62.     targetImageName = "example-watermark.png"
  63.     style = "image/watermark,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ"
  64.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  65.     if err != nil {
  66.     HandleError(err)
  67.     }
  69.     // 图片处理：格式转换。
  70.     targetImageName = "example-formatconvert.jpg"
  71.     style = "image/format,jpg"
  72.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  73.     if err != nil {
  74.     HandleError(err)
  75.     }
  76. }
  • 自定义样式以下代码用于自定义图片样式：
  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func HandleError(err error) {
  10.     fmt.Println("Error:", err)
  11.     os.Exit(-1)
  12. }
  14. func main() {
  15.     // 创建OSSClient实例。
  16.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  17.     if err != nil {
  18.     HandleError(err)
  19.     }
  21.     // 获取存储空间。
  22.     bucketName := "<yourBucketName>"
  23.     bucket, err := client.Bucket(bucketName)
  24.     if err != nil {
  25.      HandleError(err)
  26.     }
  28.     // 图片处理：自定义样式。
  29.     sourceImageName := "example.png"
  30.     targetImageName := "example-custom.png"
  31.     style := "style/<yourCustomStyleName>"
  32.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  33.     if err != nil {
  34.     HandleError(err)
  35.     }
  36. }
  • 级联处理以下代码用于级联处理图片：
  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  7. )
  9. func HandleError(err error) {
  10.     fmt.Println("Error:", err)
  11.     os.Exit(-1)
  12. }
  14. func main() {
  15.     // 创建OSSClient实例。
  16.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  17.     if err != nil {
  18.     HandleError(err)
  19.     }
  21.     // 获取存储空间。
  22.     bucketName := "<yourBucketName>"
  23.     bucket, err := client.Bucket(bucketName)
  24.     if err != nil {
  25.     HandleError(err)
  26.      }
  28.     // 图片处理：自定义样式。
  29.     sourceImageName := "example.png"
  30.     targetImageName := "example-cascade.png"
  31.     style := "image/resize,m_fixed,w_100,h_100/rotate,90"
  32.     err = bucket.GetObjectToFile(sourceImageName, targetImageName, oss.Process(style))
  33.     if err != nil {
  34.      HandleError(err)
  35.     }
  36. }

图片处理持久化

以下代码用于图片处理持久化： 

  1. package main
  3. import (
  4.     "fmt"
  5.     "os"
  6.     "encoding/base64"
  7.     "github.com/aliyun/aliyun-oss-go-sdk/oss"
  8. )
  10. func HandleError(err error) {
  11.     fmt.Println("Error:", err)
  12.     os.Exit(-1)
  13. }
  15. func main() {
  16.     // 创建OSSClient实例。
  17.     client, err := oss.New("<yourEndpoint>", "<yourAccessKeyId>", "<yourAccessKeySecret>")
  18.     if err != nil {
  19.     HandleError(err)
  20.     }    
  22.     // 获取存储空间。
  23.     bucketName := "<yourBucketName>"
  24.     bucket, err := client.Bucket(bucketName)
  25.     if err != nil {
  26.      HandleError(err)
  27.     }
  30.     // 图片处理持久化：缩放。目标图片默认会存放到相同的bucket中。
  31.     sourceImageName := "example.png"
  32.     targetImageName := "example-resize.png"
  33.     style := "image/resize,m_fixed,w_100,h_100"
  34.     process := fmt.Sprintf("%s|sys/saveas,o_%v", style, base64.URLEncoding.EncodeToString([]byte(targetImageName)))
  35.     result, err := bucket.ProcessObject(sourceImageName, process)
  36.     if err != nil {
  37.     HandleError(err)
  38.     } else {
  39.         fmt.Println(result)
  40.     }
  42.     // 图片处理持久化：缩放。将目标图片存放到不同的bucket中。
  43.     targetBucketName := "<yourTargetBucketName>"
  44.     targetImageName = "example-crop-different-bucket.png"
  45.     style = "image/resize,m_fixed,w_100,h_100"
  46.     process = fmt.Sprintf("%s|sys/saveas,o_%v,b_%v", style, base64.URLEncoding.EncodeToString([]byte(targetImageName)), base64.URLEncoding.EncodeToString([]byte(targetBucketName)))
  47.     result, err = bucket.ProcessObject(sourceImageName, process)
  48.     if err != nil {
  49.     HandleError(err)
  50.     } else {
  51.         fmt.Println(result)
  52.     }
  54.     // 图片处理持久化：裁剪。
  55.     targetImageName = "example-crop.png"
  56.     style = "image/crop,w_100,h_100,x_100,y_100,r_1"
  57.     process = fmt.Sprintf("%s|sys/saveas,o_%v", style, base64.URLEncoding.EncodeToString([]byte(targetImageName)))
  58.     result, err = bucket.ProcessObject(sourceImageName, process)
  59.     if err != nil {
  60.     HandleError(err)
  61.     } else {
  62.         fmt.Println(result)
  63.     }
  65.     // 图片处理持久化：旋转。
  66.     targetImageName = "example-rotate.png"
  67.     style = "image/rotate,90"
  68.     process = fmt.Sprintf("%s|sys/saveas,o_%v", style, base64.URLEncoding.EncodeToString([]byte(targetImageName)))
  69.     result, err = bucket.ProcessObject(sourceImageName, process)
  70.     if err != nil {
  71.     HandleError(err)
  72.     } else {
  73.         fmt.Println(result)
  74.     }
  76.     // 图片处理持久化：锐化。
  77.     targetImageName = "example-sharpen.png"
  78.     style = "image/sharpen,100"
  79.     process = fmt.Sprintf("%s|sys/saveas,o_%v", style, base64.URLEncoding.EncodeToString([]byte(targetImageName)))
  80.     result, err = bucket.ProcessObject(sourceImageName, process)
  81.     if err != nil {
  82.     HandleError(err)
  83.     } else {
  84.        fmt.Println(result)
  85.     }
  87.     // 图片处理持久化：水印。
  88.     targetImageName = "example-watermark.png"
  89.     style = "image/watermark,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ"
  90.     process = fmt.Sprintf("%s|sys/saveas,o_%v", style, base64.URLEncoding.EncodeToString([]byte(targetImageName)))
  91.     result, err = bucket.ProcessObject(sourceImageName, process)
  92.     if err != nil {
  93.     HandleError(err)
  94.     } else {
  95.         fmt.Println(result)
  96.     }
  98.     // 图片处理持久化：格式转换。
  99.     targetImageName = "example-formatconvert.jpg"
  100.     style = "image/format,jpg"
  101.     process = fmt.Sprintf("%s|sys/saveas,o_%v", style, base64.URLEncoding.EncodeToString([]byte(targetImageName)))
  102.     result, err = bucket.ProcessObject(sourceImageName, process)
  103.     if err != nil {
  104.     HandleError(err)
  105.     } else {
  106.         fmt.Println(result)
  107.     }
  108. }

图片处理工具

您可以通过可视化图片处理工具ImageStyleViewer直观地看到OSS图片处理结果。