Python-SDK 之如何实现图片处理？

OSS图片处理是OSS对外提供的海量、安全、低成本、高可靠的图片处理服务。用户将原始图片上传保存到OSS，通过简单的 RESTful 接口，在任何时间、任何地点、任何互联网设备上对图片进行处理。图片处理提供图片处理接口，图片上传请使用上传接口。基于OSS图片处理，用户可以搭建自己的图片处理服务。

图片处理基础功能


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

• 获取图片信息
• 图片格式转换
• 图片缩放、裁剪、旋转
• 图片效果
• 图片添加图片、文字、图文混合水印
• 自定义图片处理样式，在控制台的 图片处理 -> 样式管理 中定义
• 通过级联处理调用多个图片处理功能

图片处理使用


图片处理使用标准的 HTTP GET 请求来访问，所有的处理参数是编码在 URL 中的QueyString。

匿名访问


如果图片文件（Object）的访问权限是 公共读 ，如下表所示的权限，则可以匿名访问图片服务。

Bucket权限	Object权限
公共读私有写（public-read）或 公共读写（public-read-write）	默认（default）
任意权限	公共读私有写（public-read）或 公共读写（public-read-write）

通过如下格式的三级域名匿名访问图片处理：

1. http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value

• bucket：用户的存储空间（bucket）名称
• endpoint：用户存储空间所在数据中心的访问域名
• object：用户上传在OSS上的图片文件
• image：图片处理保留标志符
• action：用户对图片做的操作，如缩放、裁剪、旋转等
• parame：用户对图片做的操作所对应的参数

例如：

1. http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100

自定义样式，使用如下格式的三级域名匿名访问图片处理：

1. http://bucket.<endpoint>/object?x-oss-process=x-oss-process=style/name

• style：用户自定义样式系统保留标志符
• name：自定义样式名称，即控制台定义样式的 规则名

例如：

1. http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/oss-pic-style-w-100

通过级联处理，可以对一张图片顺序实施多个操作，格式如下：

1. http://bucket.<endpoint>/object?x-oss-process=image/action,parame_value/action,parame_value/...

例如：

1. http://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100/rotate,90

图片服务也支持HTTPS访问，例如：

1. https://image-demo.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=image/resize,w_100

授权访问


对私有权限的文件（Object），如下表所示的权限，必须通过授权才能访问图片服务。

Bucket权限	Object权限
私有读写（private）	默认权限（default）
任意权限	私有读写（private）

生成带签名的图片处理的URL代码如下：

1. # -*- coding: utf-8 -*-
3. import oss2
5. endpoint = '<endpoint, 例如http://oss-cn-hangzhou.aliyuncs.com>'
6. access_key_id = '<access_key_id>'
7. access_key_secret = '<access_key_secret>'
8. bucket_name = '<bucket_name>'
9. key = 'example.jpg'
11. # 创建Bucket对象，所有Object相关的接口都可以通过Bucket对象来进行
12. bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
14. # 上传示例图片
15. bucket.put_object_from_file(key, 'example.jpg')
17. # 生成带签名的URL，过期时间10分钟
18. style = 'image/resize,m_fixed,w_100,h_100/rotate,90'
19. url = bucket.sign_url('GET', key, 10 * 60, params={'x-oss-process': style})
20. print(url)

提示：

• 授权访问支持 自定义样式、 HTTPS、 级联处理
• sign_url 过期时间单位是秒

SDK访问


对于任意权限的图片文件，都可以直接使用 SDK 访问图片、进行处理。

提示：

• 图片处理的完整代码请参考：GitHub
• SDK处理图片文件支持 自定义样式、 HTTPS、 级联处理

基础操作


图片处理的基础操作包括， 获取图片信息、 格式转换、 缩放、 裁剪、 旋转、 效果、 水印等。

1. # -*- coding: utf-8 -*-
3. import os
4. import oss2
6. endpoint = '<endpoint, 例如http://oss-cn-hangzhou.aliyuncs.com>'
7. access_key_id = '<access_key_id>'
8. access_key_secret = '<access_key_secret>'
9. bucket_name = '<bucket_name>'
10. key = 'example.jpg'
11. new_pic = 'example-new.jpg'
13. # 创建Bucket对象，所有Object相关的接口都可以通过Bucket对象来进行
14. bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
16. # 上传示例图片
17. bucket.put_object_from_file(key, 'example.jpg')
19. # 图片缩放
20. style = 'image/resize,m_fixed,w_100,h_100'
21. bucket.get_object_to_file(key, new_pic, process=style)
23. # 图片裁剪
24. style = 'image/crop,w_100,h_100,x_100,y_100,r_1'
25. bucket.get_object_to_file(key, new_pic, process=style)
27. # 图片旋转
28. style = 'image/rotate,90'
29. bucket.get_object_to_file(key, new_pic, process=style)
31. # 图片锐化
32. style = 'image/sharpen,100'
33. bucket.get_object_to_file(key, new_pic, process=style)
35. # 图片加文字水印
36. style = 'image/watermark,text_SGVsbG8g5Zu-54mH5pyN5YqhIQ'
37. bucket.get_object_to_file(key, new_pic, process=style)
39. # 图片格式转换
40. style = 'image/format,png'
41. bucket.get_object_to_file(key, new_pic, process=style)
43. # 删除示例图片
44. bucket.delete_object(key)
45. # 清除本地文件
46. os.remove(new_pic)

提示： get_object也支持图片处理功能

自定义样式

1. # -*- coding: utf-8 -*-
3. import os
4. import oss2
6. endpoint = '<endpoint, 例如http://oss-cn-hangzhou.aliyuncs.com>'
7. access_key_id = '<access_key_id>'
8. access_key_secret = '<access_key_secret>'
9. bucket_name = '<bucket_name>'
10. key = 'example.jpg'
11. new_pic = 'example-new.jpg'
13. # 创建Bucket对象，所有Object相关的接口都可以通过Bucket对象来进行
14. bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
16. # 上传示例图片
17. bucket.put_object_from_file(key, 'example.jpg')
19. # 自定义样式
20. style = 'style/oss-pic-style-w-100'
22. # 图片处理
23. bucket.get_object_to_file(key, new_pic, process=style)
25. # 删除示例图片
26. bucket.delete_object(key)
27. # 清除本地文件
28. os.remove(new_pic)

提示： get_object也支持图片处理功能

级联处理

1. # -*- coding: utf-8 -*-
3. import os
4. import oss2
6. endpoint = '<endpoint, 例如http://oss-cn-hangzhou.aliyuncs.com>'
7. access_key_id = '<access_key_id>'
8. access_key_secret = '<access_key_secret>'
9. bucket_name = '<bucket_name>'
10. key = 'example.jpg'
11. new_pic = 'example-new.jpg'
13. # 创建Bucket对象，所有Object相关的接口都可以通过Bucket对象来进行
14. bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
16. # 上传示例图片
17. bucket.put_object_from_file(key, 'example.jpg')
19. # 级联处理
20. style = 'image/resize,m_fixed,w_100,h_100/rotate,90'
22. # 图片处理
23. bucket.get_object_to_file(key, new_pic, process=style)
25. # 删除示例图片
26. bucket.delete_object(key)
27. # 清除本地文件
28. os.remove(new_pic)

提示： get_object也支持图片处理功能

图片处理工具

• 可视化图片处理工具 ImageStyleViever ，可以直观的看到OSS图片处理的结果
• OSS图片处理的功能、使用演示 页面